Markdown 教程
一个展示如何编写 markdown 文件的 markdown 示例。本文档整合了核心语法和扩展(GMF)。
块元素
段落和换行
段落
HTML 标签:<p>
一个或多个空行。(只包含空格或制表符的行被视为空行。)
代码:
这将是内联的。
这是第二段。预览:
这将是 内联的。
这是第二段。
换行
HTML 标签:<br />
以两个或更多空格结束一行。
代码:
这将不会内联。预览:
这将不会
内联。
标题
Markdown 支持两种标题样式,Setext 和 atx。
Setext
HTML 标签:<h1>, <h2>
使用等号 (=) 作为 <h1>,破折号 (-) 作为 <h2> 来”下划线”,数量不限。
代码:
这是 H1=============这是 H2-------------预览:
这是 H1
这是 H2
Atx
HTML 标签:<h1> ~ <h6>
在行首使用 1-6 个井号 (#),对应标题级别 1-6。
代码:
# 这是 H1## 这是 H2###### 这是 H6预览:
这是 H1
这是 H2
这是 H6
引用
HTML 标签:<blockquote>
在每一行开头使用 >。
Code:
> 这是引用。> 这是引用的第二行。>> 这是引用的第二段。预览:
这是引用。 这是引用的第二行。
这是引用的第二段。
嵌套
引用可以嵌套。
代码:
> 这是第一层引用。>> > 这是嵌套的引用。>> 回到第一层。预览:
这是第一层引用。
这是嵌套的引用。
回到第一层。
列表
Markdown 支持有序列表和无序列表。
无序列表
HTML 标签:<ul>
使用 星号 (*)、加号 (+) 或破折号 (-) 作为列表标记。
代码:
* 红色* 绿色* 蓝色预览:
- 红色
- 绿色
- 蓝色
有序列表
HTML 标签:<ol>
使用数字后跟句点。
代码:
1. 鸟2. 麦克海尔3. 帕里什预览:
- 鸟
- 麦克海尔
- 帕里什
代码块
HTML 标签:<pre><code>
每行缩进至少 4 个空格或 1 个制表符。
代码:
这是一个普通段落:
这是一个代码块。预览:
这是一个普通段落:
这是一个代码块。分隔线
HTML 标签:<hr />
在一行中使用三个或更多的破折号、星号或下划线。
代码:
***---___预览:
表格
使用 竖线 (|) 和破折号 (-) 创建表格。
代码:
| 表头 1 | 表头 2 || ------ | ------ || 单元格 1 | 单元格 2 || 单元格 3 | 单元格 4 |预览:
| 表头 1 | 表头 2 |
|---|---|
| 单元格 1 | 单元格 2 |
| 单元格 3 | 单元格 4 |
对齐
你可以通过在分隔线中添加冒号 (:) 来指定列的对齐方式。
代码:
| 左对齐 | 居中对齐 | 右对齐 || :---- | :----: | ----: || 单元格 1 | 单元格 2 | 单元格 3 || 单元格 4 | 单元格 5 | 单元格 6 |预览:
| 左对齐 | 居中对齐 | 右对齐 |
|---|---|---|
| 单元格 1 | 单元格 2 | 单元格 3 |
| 单元格 4 | 单元格 5 | 单元格 6 |
行内元素
链接
Markdown 支持两种链接样式:内联和引用。
内联
代码:
这是 [示例](http://example.com/ "标题") 内联链接。
[这个链接](http://example.net/) 没有标题属性。预览:
这是 示例 内联链接。
这个链接 没有标题属性。
引用
代码:
这是 [示例][id] 引用样式链接。
[id]: http://example.com/ "可选标题"预览:
这是 示例 引用样式链接。
强调
Markdown 将星号 (*) 和下划线 (_) 视为强调指示符。
斜体
HTML 标签:<em>
用一个 * 或 _ 包裹。
代码:
*单星号*
_单下划线_预览:
单星号
单下划线
粗体
HTML 标签:<strong>
用两个 * 或 _ 包裹。
代码:
**双星号**
__双下划线__预览:
双星号
双下划线
代码
HTML 标签:<code>
用反引号 (`) 包裹。
代码:
使用 `printf()` 函数。预览:
使用 printf() 函数。
图片
Markdown 使用类似链接语法的图片语法,允许两种样式:内联和引用。
内联
代码:

引用
代码:
![替代文本][id]
[id]: /path/to/img.jpg "可选标题"删除线
HTML 标签:<del>
用两个波浪号 (~~) 包裹。
代码:
~~删除文本~~预览:
删除文本
其他
自动链接
Markdown 支持自动创建 URL 和电子邮件地址链接的快捷样式。
代码:
<http://example.com/>
<address@example.com>预览:
反斜杠转义
Markdown 允许你使用反斜杠转义来生成字面字符。
代码:
\*字面星号\*预览:
*字面星号*
内联 HTML
你可以在 Markdown 中使用原始 HTML。
代码:
<div>这是一个 div。</div>预览:
如果这篇文章对你有帮助,欢迎分享给更多人!
部分信息可能已经过时






