Markdown-语法说明

Markdown 语法说明概述宗旨兼容 HTML特殊字符自动转换区块元素段落和换行标题区块引用列表代码区块分隔线区段元素链接强调代码图片其它自动链接反斜杠Markdown 免费编辑器概述宗旨Markdown 的目标是实现「易读易写」。兼容 HTMLMarkdown 支持HTML标签的解析。如：在 Markdown 文件里加上一段 HTML 表格：1. 这是一个普通段落。2. table3.     tr4.         tdFoo/td5.     /tr6. /table7. 8. 这是另一个普通段落。这是一个普通段落。Foo这是另一个普通段落。特殊字符自动转换在 HTML 文件中，有两个字符需要特殊处理：  和 & 。 符号用于起始标签，& 符号则用于标记 HTML 实体，如果你只是想要显示这些字符的原型，你必须要使用实体的形式，像是 <; 和 &;。 AT&T, 4  5区块元素段落和换行一个 Markdown 段落是由一个或多个连续的文本行组成，它的前后要有一个以上的空行（空行的定义是显示上看起来像是空的，便会被视为空行。比方说，若某一行只包含空格和制表符，则该行也会被视为空行）。普通段落不该用空格或制表符来缩进。1. This is a paragraph demonstrate2. 3. how to start a new line.This is a paragraph demonstrate howto start a new line.标题Markdown 支持两种标题的语法，类 Setext 和类 atx 形式。类 Setext 形式是用底线的形式，利用 = （昀高阶标题）和 ­ （第二阶标题），例如：1. This is an H12. =============3. This is an H24. ­­­­­­­­­­­­­This is an H1This is an H2类 Atx 形式则是在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶，例如：1. # 这是 H12. ## 这是 H23. ###### 这是 H6这是 H1这是 H2这是 H6区块引用 BlockquotesMarkdown 标记区块引用是使用类似 email 中用  的引用方式。如果你还熟悉在 email 信件中的引言部分，你就知道怎么在 Markdown 文件中建立一个区块引用，那会看起来像是你自己先断好行，然后在每行的昀前面加上  ：1.  This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,2.  consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.3.  Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.4. 5.  Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse6.  id sem consectetuer libero luctus adipiscing.This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enimwisi, viverra nec, fringilla in, laoreet vitae, risus.Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.引用的区块内也可以使用其他的 Markdown 语法，包括标题、列表、代码区块等：1.  ## 这是一个标题。2. 3.  1.   这是第一行列表项。4.  2.   这是第二行列表项。5. 6.  给出一些例子代码：7. 8.      return shell_exec(echo $input | $markdown_script);9.  This is nested blockquote.这是一个标题。1. 这是第一行列表项。2. 这是第二行列表项。给出一些例子代码：1. return shell_exec(echo $input | $markdown_script);2.   This is nested blockquote.列表Markdown 支持有序列表和无序列表。 无序列表使用星号、加号或是减号作为列表标记：1. *   Red2. *   Green3. *   BlueRedGreenBlue有序列表则使用数字接着一个英文句点：1. 1.  Bird2. 2.  McHale3. 3.  Parish1. Bird2. McHale3. Parish行首出现数字­句点­空白，要避免这样的状况，你可以在句点前面加上反斜杠。1. 1986\. What a great season.1986. What a great season.代码区块要在 Markdown 中建立代码区块很简单，只要简单地缩进 4 个空格或是 1 个制表符就可以，例如，下面的输入：1. 这是一个普通段落：2. 3.     这是一个代码区块。这是一个普通段落：1. 这是一个代码区块。2.   分隔线下面每种写法都可以建立分隔线：1. * * *2. 3. ***4. 5. *****6. 7. ­ ­ ­8. 9. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­区段元素Markdown 支持两种形式的链接语法： 行内式和参考式两种形式。要建立一个行内式的链接，只要在方块括号后面紧接着圆括号并插入网址链接即可，如果你还想要加上链接的title文字，只要在网址后面，用双引号把title 文字包起来即可，例如：1. This is [an example]( Title) inline link.2. 3. [This link]() has no title attribute.This is an example inline link.This link has no title attribute.如果你是要链接到同样主机的资源，你可以使用相对路径：1. See my [About](/about/) page for details.See my About page for details.参考式的链接是在链接文字的括号后面再接上另一个方括号，而在第二个方括号里面要填入用以辨识链接的标记：1. I get 10 times more traffic from [Google] [1] than from2. [Yahoo] [2] or [MSN] [3].3. 4. [1]:         Google5. [2]:   Yahoo Search6. [3]:     MSN SearchI get 10 times more traffic from Google than from Yahoo or MSN. 链接内容定义的形式为：方括号（前面可以选择性地加上至多三个空格来缩进），里面输入链接文字接着一个冒号接着一个以上的空格或制表符接着链接的网址选择性地接着 title 内容，可以用单引号、双引号或是括弧包着强调Markdown 使用星号（*）和底线（_）作为标记强调字词的符号，被*或_包围的字词会被转成用em标签包围，用两个*或_包起来的话，则会被转成strong，例如：1. *single asterisks*2. 3. _single underscores_4. 5. **double asterisks**6. 7. __double underscores__single asteriskssingle underscoresdouble asterisksdouble underscores代码如果要标记一小段行内代码，你可以用反引号把它包起来（`），例如：1. Use the `printf()` function.Use the printf() function.如果要在代码区段内插入反引号，你可以用多个反引号来开启和结束代码区段：1. ``There is a literal backtick (`) here.``There is a literal backtick (`) here.图片很明显地，要在纯文字应用中设计一个「自然」的语法来插入图片是有一定难度的。Markdown 使用一种和链接很相似的语法来标记图片，同样也允许两种样式： 行内式 和 参考式。行内式的图片语法看起来像是：1. 2. 3. null详细叙述如下：一个惊叹号 ! 接着一个方括号，里面放上图片的替代文字 接着一个普通括号，里面放上图片的网址，昀后还可以用引号包住并加上 选择性的 'title' 文字。参考式的图片语法则长得像这样：1. ![Alt text][id]2. [id]: url/to/image  Optional title attribute 到目前为止， Markdown 还没有办法指定图片的宽高，如果你需要的话，你可以使用普通的  标签。如果你想使图片带有超链接的功能，即点击一个图片进入一个指定的网页。那么可以这样写：1. [![cpr]](img/computer.png)2. [cpr]:img/computer.png computer[其它自动链接Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用尖括号包起来， Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样，例如：1. ://example.com/反斜杠Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号，例如：如果你想要用星号加在文字旁边的方式来做出强调效果（但不用 em 标签），你可以在星号的前面加上反斜杠：1. \*literal asterisks\**literal asterisks*Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：1. \   反斜线2. `   反引号3. *   星号4. _   底线5. {}  花括号6. []  方括号7. ()  括弧8. #   井字号9. +   加号10. ­   减号11. .   英文句点12. !   惊叹号Markdown 免费编辑器Windows 平台MarkdownPadMarkPadLinux 平台ReTextMac 平台Mou在线编辑器Markable.inDillinger.io浏览器插件MaDe (Chrome)