Markdown 是什么, 可以看 Wiki, 下面看语法 关于 Markdown 的未来可以看这篇文章 http://www.codinghorror.com/blog/2012/10/the-future-of-markdown.html Markdown 项目主页在 Daring Fireball 的网站上有具体的说明

SegmentFault 的语法说明 http://blog.segmentfault.com/dongoer/1190000000339653 WowUbuntu 的语法说明 http://wowubuntu.com/markdown/

Markdown 有多个实现, Github, 以及国内很多社区都是使用 GFM 包括 Python China, Ruby China, SegmentFault 都用了 GFM 语法 有 Node 模块 marked 支持 GFM 的渲染 GFM 和原始 Markdown 的主要区别是 GFM 里的换行是正常的, 其次代码块有 ``` 的语法

网上用的标记, 主要是链接, 代码, 其他在一般帖子里不太需要

GFM 的语法

链接

链接原始的 Markdown 语法是加 <>, 在 GFM 里可以自动识别

http://daringfireball.net/ http://daringfireball.net/

http://daringfireball.net/
<http://daringfireball.net/>

标记文本为链接 MaDe 编辑器

标记文本为链接 [MaDe 编辑器](http://lyric.im/ma-de-markdown-wysiwyg-editor/)

为链接取别名 [名叫 marked 的 iOS 应用][app] [app]: http://markedapp.com/

为链接取别名 [名叫 marked 的 iOS 应用][app]
[app]: http://markedapp.com/

代码

代码有句中的代码, 代码块, 都是用的 ` 作为符号标记的 句中用 1 个或者 2 个, 而代码块用 3 个单独作为行的反引号

代码有句中的代码, 代码块, 都是用的 `` ` `` 作为符号标记的
句中用 `1` 个或者 `2` 个, 而代码块用 `3` 个单独作为行的反引号

另外 Github 上在代码块第一行反引号之后可以声明语法 比如 JS 下面这样就会被在 HTML 标记上一些属性 Github 站点上会直接对代码形成语法高亮

console.log('sonething');

```js
console.log('sonething');
```

marked 就可以配合 Highlight.js 在编译时高亮代码, 方便博客排版

图片

图片的标记和链接非常相似, 方括号文本部分在对应图片的 alt 属性, 后边括号是网址:

![Mark-Down][cat-girl] [cat-girl]: http://octodex.github.com/images/aidorucat.png

[![Mark-Down][cat-boy]][octocat] [cat-boy]: http://octodex.github.com/images/codercat.jpg [octocat]: http://octodex.github.com/codercat

![Mark-Up](http://d2o0t5hpnwv4c1.cloudfront.net/2063_markdown/preview.png)

![Mark-Down][cat-girl]
[cat-girl]: http://octodex.github.com/images/aidorucat.png

[![Mark-Down][cat-boy]][octocat]
[cat-boy]: http://octodex.github.com/images/codercat.jpg
[octocat]: http://octodex.github.com/codercat

带链接的图片比较麻烦, 不如直接在里边写 HTML… 但 HTML 需要进行过滤, 比如 CNode 上做的一些过滤

文本样式

> 开头表示引用,

Aaron Swartz

** 包围的 加粗, * 包围的 斜体, ~ 包围的删除线等等, 甚至用 HTML 标签直接添加 Markdown 不直接支持的样式可以

• 还有列表之类的功能
• 这里是无序的列表, 用 * 写在行头即可

有序列表

1. 有序列表大概的样子和无序列表一样
2. 然后数字写在行开头标记

另外还有 `>` 开头的引用,

> Aaron Swartz

`**` 包围的 **加粗**, `*` 包围的 *斜体*, `~` 包围的删除线等等,
甚至用 HTML 标签直接添加 Markdown 不直接支持的样式可以

* 还有列表之类的功能
* 这里是无序的列表, 用 `*` 写在行头即可

有序列表

1. 有序列表大概的样子和无序列表一样
2. 然后数字写在行开头标记

• 标题

标题是用 # 写在行头来标记的, 比如 ### #### 对应 h3 到 h4 标签 一个比较方便的写法是用 ------ 线来标记标题, 比如下面的:

h3

h4

h2

h1

### h3
#### h4

h2
------

h1
======

还有注意换行, 因为 ------ 上下被空行包裹时是个 <hr> 分割线

最后链上一份各种标记语言的对比, 至少看下喜欢哪个 ;p http://www.worldhello.net/gotgithub/appendix/markups.html