Markdown

Markdown_Example_DucQuoc

The basic idea of markdown is a “counterpart” of markup languages:

+ Markup languagues : using extra XML (for example HTML) -> text content

+ Markdown languages: using text -> content with format (HTML)

Basically, it’s like a syntax language to generate text -> HTML . So, if you have used some HTML Editor with text syntax (like when you using some Wiki editor to write – Confluence, Dokuwiki, Redmine, Trac, …) , you already use some markdown language.

Markdown syntax, is a specific one, and it has been adopted widely (especially on GitHub), not depending on a single wiki product. Now it’s more popular and has some implementations/variants which can be embedded in applications easily.

https://ducquoc.files.wordpress.com/2012/06/markdown_example_ducquoc.png

Some basic syntax of official Markdown (extensions .md, .markdown, .MD) :

Headers

# This is an

tag


## This is an

tag


###### This is an
tag

(nghĩa là tương ứng HTML h1 -> h7 , tùy theo số lượng # ở đầu, riêng H1 còn có thể dùng dạng 1 dòng ở dưới nhiều dấu = sát nhau, VD: https://github.com/ducquoc/euler-fun/blob/master/README.md  raw )

.

Emphasis

*This text will be italic*
_This will also be italic_

**This text will be bold**
__This will also be bold__

_You **can** combine them_

Lists

Unordered

* Item 1
* Item 2
  * Item 2a
  * Item 2b

Ordered

1. Item 1
1. Item 2
1. Item 3
   1. Item 3a
   1. Item 3b

Images

![Some Alt Text](/images/logo.png)
Format: ![Alt Text](url)

Links

[Alt text](URL)
[Duc Quoc blog](https://ducquoc.wordpress.com)

Blockquotes

As Kanye West said:

> We're living the future so
> the present is our past.

or

As Kanye West said:

```
We're living the future so
the present is our past.
```

Inline code

I think you should use an
`` element here instead.

(nghĩa là giữa 1 cặp backtick ` )

 

.

https://ducquoc.files.wordpress.com/2012/06/markdown_example_ducquoc.png

 

.

 

See also:

http://dillinger.io/

http://www.markitdown.net/markdown

https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet

https://guides.github.com/features/mastering-markdown/

https://bitbucket.org/tutorials/markdowndemo

https://markdown-it.github.io/

https://support.discordapp.com/hc/en-us/articles/210298617-Markdown-Text-101-Chat-Formatting-Bold-Italic-Underline-

https://blogs.uoregon.edu/rclub/2016/04/26/r-markdown-resources/

 

.

UPDATE 2017

 

Đã có những định dạng “reversed markup” khác cạnh tranh với MarkDown:

+ ReStructuredText //docutils.sourceforge.net/rst.html (thường .rst http://rst.ninjs.org/ )

+ AsciiDoc //asciidoc.org/ (thường .adoc https://asciidoclive.com/edit/scratch/1 )

Ngoài ra, Textile (https://txstyle.org/ ) – được xem là tiên phong truyền cảm hứng cho Markdown – cũng còn được sử dụng khá nhiều, nổi bật là các sản phẩm JIRA, Redmine, Jekyll, BaseCamp classic, …

 

 

./.

About DucQuoc.wordpress.com

A brother, husband and father...
This entry was posted in Coding, Linux. Bookmark the permalink.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s