markdown语言基本操作-10.01

概览

• 格式语法只涵盖纯文本可以涵盖的范围
• 行内还是区块，<和&两个符号都一定会被转换成HTML实体

---

区块元素

段落换行

• 一个段落由一个或多个连续的文本行组成，前后要有一个以上的空
  行

标题

• 类Setext形式
  用底线形式，=(最高阶标题)，-(第二阶标题)
• 类Atx形式
  行首插入1到6个#，对应到标题1到6阶

区块引用

• 每行的最前面加上>
• 只在整个段落的第一行最前面加上>
• 嵌套（引用内的引用），根据层次加上不同数量的>
• 引用的区块内可以使用其他的Markdown语法

列表

• 有序列表
  使用数字接着一个英文句点(数字排序与输出结果无关)
• 无序列表
  使用星号、加号或减号在行首作为列表标记
  (列表内引用需缩进，引用代码区块需缩进两次)

代码区块

• 缩进4个空格或是1个制表符
• &、<和>会自动转成HTML实体

分隔线

• 在一行中用三个以上的星号、减号、底线来建立一个分隔线
• 行内不能有其他东西
• 可以在星号或是减号中间插入空格

---

区段元素

链接

• 支持两种形式的链接语法：行内式和参考式
  • 行内式的链接
    在方块括号后面紧接着圆括号并插入网址链接(加上链接的title文字，在网址后用双引号把 title 文字包起来)
    链接到同样主机的资源(使用相对路径)

  [This link](http://example.net/) has no title attribute.

  • 参考式的链接
    链接文字的括号后面再接上另一个方括号，在第二个方括号里面要填入用以辨识链接的标记-在文件的任意处，把这个标记的链接内容定义出来

  This is [an example] [id] reference-style link.
  [id]: http://example.com/ “Optional Title Here”

  • (选择性地接着 title 内容，用单引号、双引号或括弧包着)
• 链接辨别标签并不区分大小写
• 隐式链接标记功能:省略指定链接标记.链接标记会视为等同于链接文字，要用隐式链接标记只要在链接文字后面加上一个空的方括号(定义时用链接文字)
• 链接文字都是用 [方括号] 来标记

强调

• 用星号（*）和底线（_）作为标记强调字词的符号，被 * 或_包
  围的字词会被转成用<em> 标签包围，用两个* 或_包起来的话，
  则会被转成<strong>
• 强调也可以直接插在文字中间
• 如果*和_两边都有空白，就只会被当成普通的符号
• 要在文字前后直接插入普通的星号或底线，用反斜线

代码

• 标记一小段行内代码，用反引号把它包起来（`）
• 在代码区段内插入反引号，用多个反引号来开启和结束代码区段

图片

• 允许两种样式：行内式和参考式。
  • 行内式表达

  
  

  • 参考式语法

  ![Alt text][id]
  [id]: url/to/image “Optional title attribute”

• 居中并且带尺寸的图片:
  

  

---

其他

反斜杠

• 符号前面加上反斜杠来帮助插入普通的符号:\`*_ {}[]()#+-.!

自动链接

• 以较短的自动链接形式处理网址和电子邮件信箱，用方括号包起来，就会自动把它转成链接。

<http://example.com/>

帮助文档

→