Markdown 语法

3.17K 浏览

Markdown 语法

本论坛帖子都使用Markdown 标记语法。Markdown应该是每个程序员的必备技能。

本节仅简要介绍 Markdown 的基本语法与展现,若要详细了解,英文资源可以看其发明人的说明:Jon Gruber's original spec 以及GitHub 的扩展版 Github-flavored Markdown infoj page。Markdown.cn有其中文详解;想看看俗称 GFM-GitHub 风格的 Markdown 语法,也找得到中文翻译

标题

<code> # H1 ## H2 ### H3 #### H4 ##### H5 ###### H6 最常使用的是 H1 和 H2 标题,还有更明显的另一种写法: Alt-H1 ====== Alt-H2 ------</code>

此处-是负号,不是_下横号,_下横号,显示的是双横线

H1

H2

H3

H4

H5
H6

最常使用的是 H1 和 H2 标题,还有更明显的另一种写法:

Alt-H1

Alt-H2

强调语法

<code>强调,例如意大利斜体,可以使用 *asterisks* 或 _underscores_。 加重语气强调,例如粗体,可以用 **asterisks** 或 __underscores__ 。 可以混用这两种 **asterisks and _underscores_**。 给文字加上删除线,是这样 ~~Scratch this.~~</code>

清单

下面的示例为了清楚展示缩排时需要的空格,使用了点号,实际撰写时只需要相同数量的空格。

<code>1. 第一个有序列表项 2. 另一个项 ..* 无序的子列表 1. 数字本身是否排序并不重要,统统使用相同的数字也可以 ..1. 有序的子列表 4. 另一项 ...可以在一则项目中使用缩进的段落格式。注意上面的**空行**,还有本段前的**空格**(至少一个,我们使用了三个,展示的更清楚) ...在一个段落中**强制换行**,在语句后方加入两个**空格**。.. ...这个被强制设置的独立行,依旧在同一个段落中。.. ...(有些人觉得使用空格强制换行太麻烦,例如 GFM 就不需要)。 * 可以使用星号建立无序目录 - 或是短横线(负号) + 使用半形加号也可以</code>

连接设置

有两种方式可以建立文中的链接。

<code>[这是一个行内链接](https://www.gitbook.com) [这是一个带有标题的行内链接](https://www.gitbook.com "GitBook's Homepage") [这是一个参考链接][Arbitrary case-insensitive reference text] [这是一个对应到 Git 仓库文件的相对参考链接](../blob/master/LICENSE) [参考标的物也可以使用数字][1] 直接使用文字对应也可以 [这段文字链接到参考项目] 参考项目可以写在文档的最后,有点像书内的注解(注脚)。 [arbitrary case-insensitive reference text]: https://www.mozilla.org [1]: http://slashdot.org [这段文件链接到参考项目]: http://www.reddit.com</code>

图片

<code>这是我们的 logo (将鼠标移动到图片上会显示图片标题): 行内格式: ![alt text](https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Logo 标题文字示例一") 参考链接结构: ![alt text][logo] [logo]: https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Logo 标题文字示例二"</code>

程序代码与语法高亮标示

<code>行内 `code` 必须使用 `back-ticks` 将文字包起来(一般在键盘左上方的地一个键)。</code>

整段独立展示的代码必须使用成对的三个 back-ticks ``` 包裹起来,或是使用四个空格缩排。建议使用第一种方法,可以让代码具有可读性。

image http://bbs.mallol.cn/assets/images/1-QZ2Nd7PioTWXJTqa.jpeg

引言

<code> > 引言(Blockquotes)常常出现在电子邮件中,表示摘录来信的原句。 > 这一行是引言的一部分。 Quote break. > 这是一段非常长的引言区块,只要在句首使用了正确的符号和空格,就可以持续不间断的撰写,整段文字都是会被包含在引言区块中。当然你依旧可以在引言区块中 *使用* **Markdown** 的行内格式标记语法。</code>

水平分割线

<code>三个或三个以上的符号,必须在独立的一行,前后不能有其他文字。 --- 短横线(Hyphens) *** 半形星号(Asterisks) ___ 下底/横线(Underscores)</code>

空行分隔段落

知道Markdown如何进行分段是很重要的,基本上空行代表前后的文字都会是段落(在HTML中以<p>与</p>包裹起来)。如果使用桌面编辑软件,有些可以微调空行的显示,让编辑区看起来不那么松散;甚至有些软件直接取消分行的设置,按下 return 就代表分段了。
最好的方法就是实践,打开编辑器,启用预览窗口,试着输入几次,看看有什么结果,很快就熟悉了。
尝试输入下面的内容看看:

<code>Here's a line for us to start with. This line is separated from the one above by two newlines, so it will be a *separate paragraph*. This line is also a separate paragraph, but ... This line is only separated by a single newline, so it's a separate line in the *same paragraph*.</code>

(注意:Markdown 套用了 GFM 的分行模式,因此强制断行并不需要在行后加入两个空格。)

Youtube影片

虽然无法直接嵌影片,但可以采用图片链接的模式:

<code> <a href="http://www.youtube.com/watch?feature=player_embedded&v=YOUTUBE_VIDEO_ID_HERE " target="_blank"><img src="http://img.youtube.com/vi/YOUTUBE_VIDEO_ID_HERE/0.jpg" alt="IMAGE ALT TEXT HERE" width="240" height="180" border="10" /></a></code>

也可以直接在 Markdown 这样写,但会失去尺寸和边界的设定:

<code> [![IMAGE ALT TEXT HERE](http://img.youtube.com/vi/YOUTUBE_VIDEO_ID_HERE/0.jpg)](http://www.youtube.com/watch?v=YOUTUBE_VIDED_ID_HERE)</code>

其他参考文档:

Markdown 简明语法

MarkDown 语法说明

Markdown 快速入门

0