MarkDown使用教程

一、软件使用

1.   MarkDown

维基百科：MarkDown

1.1   注释（Comment）

注释格式：`<!-- 这行文本是注释 -->`

1.2   标题（Head）

Markdown 支持两种标题的语法，类 Setext 和类 atx 形式。<br>
1.类 Setext 形式是用底线的形式，使用三个或以上连续 =（equal signs）底线标记最高阶标题，使用三个或以上连续 -（dashes）底线标记第二阶标题。例如：

第一阶标题
===
第二阶标题
---

2.类Atx形式则是在行首插入1到6个#（hash character）对应 6 阶标题。例如：

`# 这是一级标题（H1，通常用于文档标题） ` 
`## 这是二级标题（H2，有些渲染器会为二级标题添加 hr 底线）`  
`### 这是三级标题（H3）`  
`#### 这是四级标题（H4`）  
`##### 这是五级标题（H5） #####`
`###### 这是六级标题（H6) ######`

1.3   句段(Sentence/Paragraph)

换行的方法：
1.普通字段若要强制换行，则要在自然换行行尾加上两个以上空格。
2.加入<br>标签控制换行

1.4   符号（Punctuation Characters）

1. “ +、-、* ”字符可做列表用
2. “ **  ** ” 作为加粗字符 快捷键："ctrl + B"
3. “ * * ” 作为斜体字符 快捷键“ ctrl + I”
4. “ > ” 作为引用字符，快捷键“ ctrl + Q”
5. “ \ ” 作为反编译字符
6. 行首插入“tab”或四个空格缩进表示 <pre> 预格式化
7. 引用、列表的bullet标记符前的“tab”或空格用于缩进嵌套层级
8. “ &nbsp; ”表示键盘空格
9. 使用三个及以上的“*”、“-”、“_”表示分割线

1.5   文本格式（Text Styling）

1.强调:   **加粗** 、__加粗__、*斜体*、_斜体_
2.高亮、下划线、删除线、脚注 等MarkDown不支持

1.6 nbsp; 链接（HyperLink）

1.自动链接：当我们在书写一个网址时能自动生成标题与网）一致的链接，这种链接也即自动链接。
2.用"<>"包含的文字也被识别为自动链接
3.行内式语法格式：[text](url)，如果链接到本机资源可使用相对路径。
4.参考式语法格式：[text][id]，在别的地方指出[id]链接地址

1.7   图片（image）

插入图片的语法格式：![alt_text](url)

1.8   锚点（inner link）

1.构建页内锚点的语法，类似参考式链接：
    先定义锚点id：<a href="#auchor_id">bookmark_text</a>
    再定义一个id为auchor_id的对象（这里以<p>为例）：<p id="auchor_id">auchor_text</p>

1.9   引用（Blockquote）

行首的多重引用标记可以实现嵌套缩进效果，嵌套深入浅出时，需要添加空行（blank line）或者空引用行。

第一部分

第二部分

第三部分

第二部分

第一部分

1.10 &nsbp;代码（Code）

1.行内代码：如果要标记行内代码片段，可以用反引号包裹。
2.代码块：如果要插入跨行片段或块，且要保持排版样式（包括空格、换行符和缩进），可使用预格式化引用语法格式。

1.11 &nsbp; 列表（list）

1.无序列表（Unordered List）:项目的行首使用星号（或加号，或减号）加空格作为列表标记;
通过在列表标记前面增加 tab 阶次来实现嵌套效果。
2.有序列表（ordered / numbered）项目的行首则使用数字接一个英文句点标记。