Markdown入门指南

目录

  1. 什么是 Markdown
  2. 为什么需要 Markdown
  3. 如何掌握 Markdown
    • Markdown 基本语法(Basic Markdown)
    • Markdown 扩展语法(GitHub Flavored Markdown)
    • Markdown 高级用法
  4. Markdown 相关资源

什么是 Markdown

  • Markdown 是一种适用于网络书写的轻量级「标记语言」
  • Markdown 理念是能让文档更容易读、写和随意改。
  • Markdown 以纯文本发布,用简洁的语法代替排版。

下面是一段 Markdown 示例:

 # Why *you* should use Markdown to write your next blog post

 [Markdown][1] is just so dang legible, it will make your *whole life* easier. **I promise.**

 [1]: http://daringfireball.net/projects/markdown/basics

相比较,对应的 HTML Markup 语言是这样的:

 <h1>Why <em>you</em> should use Markdown to write your next blog post</h1>

 <p><a href="http://daringfireball.net/projects/markdown/">Markdown</a>
 is just so dang legible, it will make your <em>whole life</em> easier. <strong>I promise.</strong>
 </p>

怎么样,是不是感觉 Markdown 语言读、写起来都更清爽呢:-)

为什么需要 Markdown

Markdown 优点

  • 纯文本,所以兼容性极强,可以用所有文本编辑器打开。
  • Markdown 的标记语法有极好的可读性。
  • 让你专注于文字而不是排版。
  • 格式转换方便,Markdown 的文本你可以轻松转换为 html、电子书等。

谁在使用 Markdown

Markdown 诞生于互联网时代,更是由深谙互联网文本之道的 John Gruber 等人设计。因为 Ruby 与 Github 圈的极客们的热捧,以及来自 GithubStackoverflow 等网站的大力支持(Github 和 Stackoverflow 的 Issues, comments, pull request descriptions and READMEs 都支持 Markdown 语法)。从一开始,就建立一个完整的生态链。

一切就这么简单。Markdown之所以在被鼓吹之后,越来越流行,不是因为它复杂,而是因为它足够简单。

如何掌握 Markdown

Markdown 的语法十分简单。常用的标记符号不超过十个,5分钟即可掌握。应该是为数不多,你真的可以彻底学会的语言。

基本 Markdown 语法

1. 标题

 # 一级标题
 ## 二级标题
 ### 三级标题
 #### 四级标题
 ##### 五级标题
 ###### 六级标题

2. 列表

 - 无序列表1
 - 无序列表2
 - 无序列表3

 1. 有序列表1
 2. 有序列表2
 3. 有序列表3

3. 引用

 > 这个是引用
 > 是不是和电子邮件中的
 > 引用格式很像

4. 粗体与斜体

 **这个是粗体**
 *这个是斜体*

5. 链接与图片

插入链接

inline style:

 [link text](http://example.com/ "optional title")

reference style:

 [link text][id]
 [id]: http://example.com/  "optional title here"

automatic link:

<http://example.com/> or <address@example.com>

插入图片

 ![alt text](/path/to/img.jpg "optional title")

图片链接

 [![][jane-eyre-pic]][jane-eyre-douban]

 [jane-eyre-pic]: http://img3.douban.com/mpic/s1108264.jpg
 [jane-eyre-douban]: http://book.douban.com/subject/1141406/

6. 代码

用TAB键起始的段落,会被认为是代码块

      <php>
           echo “hello world";
      </php>

如果在一个行内需要引用代码,只要用反引号`引起来就好

 Use the `printf()` function.

7. 分割线

可以在一行中用三个以上的星号、减号、底线来建立一个分隔线

 ---

:更详细的 Markdown 基本语法,请参考[Markdown中文版语法说明][1]
[1]: http://wowubuntu.com/markdown/

扩展 Markdown 语法(github扩展语法)

1. 删除线

 ~~Mistaken text.~~

2. 代码块与语法高亮

 ```ruby
 require 'redcarpet'
 markdown = Redcarpet.new("Hello World!")
 puts markdown.to_html
 ```

3. 表格

 | Tables        | Are           | Cool  |
 | ------------- |:-------------:| -----:|
 | col 3 is      | right-aligned | $1600 |
 | col 2 is      | centered      |   $12 |
 | zebra stripes | are neat      |    $1 |

4. 任务列表

 - [x] @mentions, #refs, [links](), **formatting**, and <del>tags</del> are supported
 - [x] list syntax is required (any unordered or ordered list supported)
 - [x] this is a complete item
 - [ ] this is an incomplete item

注1:更详细的 Markdown 扩展语法,请参考[GFM(Github Flavored Markdown)][2]
注2:GFM扩展语法并非所有的 Markdown 编辑器都支持。
[2]: https://help.github.com/articles/github-flavored-markdown/

其他高级用法

Cross-reference (named anchor) in markdown

 Take me to [pookie](#pookie)

 <a name="pookie"></a>

参考这里(http://stackoverflow.com/questions/5319754/cross-reference-named-anchor-in-markdown

引用代码块中包含反引号

只需使用比代码块中反引号更多的连续反引号来实现
例如:引用 Markdown 代码区段:

 ````
 ```
 print($abc, `abc`, ``ab``);

 ```
 ````

Markdown 相关资源

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,793评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,567评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,342评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,825评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,814评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,680评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,033评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,687评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,175评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,668评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,775评论 1 332
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,419评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,020评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,978评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,206评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,092评论 2 351
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,510评论 2 343

推荐阅读更多精彩内容

  • Markdown 语法手册 概述宗旨兼容HTML特殊字符子自动转换 区块元素段落和换行标题区块引用列表代码区块列表...
    Junting阅读 526评论 0 0
  • 导语 MarkDown是一种轻量级的[标记语言],它的有点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。看到...
    N_Nsd阅读 1,270评论 1 3
  • 导语: Markdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。...
    葛朋1990阅读 491评论 0 0
  • 写在前面:这是我自己学习MarkDown的一篇文章,我直接按照原来的格式去写一份,边写文章边学MarkDown,原...
    IUVO阅读 579评论 0 0
  • 家里有父母留下的一套房子,虽旧,又是六楼,但靠街,且在一环之内,闲着也是闲着,就商议着准备出租。刚把出租启事贴在住...
    川江水阅读 198评论 0 2