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 个 # 号,对应 <h1> 到 <h6>。
代码:
# 这是一级标题## 这是二级标题###### 这是六级标题预览:
这是一级标题
这是二级标题
这是六级标题
atx 样式标题可以选择性地在末尾“闭合”。末尾的 # 数量不需要与开头匹配。
代码:
# 这是一级标题 ### 这是二级标题 ##### 这是三级标题 ######预览:
这是一级标题
这是二级标题
这是三级标题
引用
HTML 标签:<blockquote>
Markdown 使用邮件风格的 > 字符进行引用。建议在硬换行时每一行都加上 >。
代码:
> 这是一段包含两个段落的引用。Lorem ipsum dolor sit amet,> consectetuer adipiscing elit.>> Donec sit amet nisl.预览:
这是一段包含两个段落的引用。Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Donec sit amet nisl.
Markdown 也允许“偷懒”,只需在每一段的第一行加上 > 即可。
引用可以嵌套(通过添加更多的 >)。
代码:
> 第一级引用>> > 嵌套引用>> 回到第一级。预览:
第一级引用
嵌套引用
回到第一级。
引用中可以包含其他 Markdown 元素,如标题、列表和代码块。
列表
Markdown 支持有序(数字)和无序(项目符号)列表。
无序列表
HTML 标签:<ul>
使用 星号 (*), 加号 (+), 或 减号 (-)。
代码:
* 红* 绿* 蓝预览:
- 红
- 绿
- 蓝
有序列表
HTML 标签:<ol>
使用数字加点:
代码:
1. 第一项2. 第二项3. 第三项预览:
- 第一项
- 第二项
- 第三项
如果不想触发有序列表,可以转义那个点:
代码:
1986\. 这不是列表,这是一句话。预览:
1986. 这不是列表,这是一句话。
代码块
HTML 标签:<pre>
将每一行缩进至少 4 个空格 或 1 个制表符。
围栏代码块
使用 ``` 包裹代码,无需缩进。
代码:
```function test() { console.log("Hello World");}```预览:
function test() { console.log("Hello World");}语法高亮
在围栏代码块后面加上语言名称即可开启高亮。
def hello puts "Hello"end水平分割线
HTML 标签:<hr />
在一行中使用三个或多个 减号 (-), 星号 (*), 或 下划线 (_)。
表格
HTML 标签:<table>
使用 管道符 (|) 分隔列,破折号 (-) 分隔表头,冒号 (:) 控制对齐。
代码:
| 左对齐 | 居中 | 右对齐 ||:---|:---:|---:|| A | B | C |预览:
| 左对齐 | 居中 | 右对齐 |
|---|---|---|
| A | B | C |
行内元素
链接
HTML 标签:<a>
行内式
[链接文字](URL "标题")
示例:百度
参考式
[id]: URL "标题"
[链接文字][id]
强调
HTML 标签:<em> (斜体), <strong> (粗体)
*斜体*或_斜体_**粗体**或__粗体__
代码
HTML 标签:<code>
使用**反引号 ()** 包裹。 示例:print(“Hello”)`
图像
HTML 标签:<img />
语法:
杂项
自动链接
使用尖括号:<https://example.com>
反斜杠转义
Markdown 使用反斜杠来显示原有的特殊字符(如 \* 显示为星号)。
行内 HTML
Markdown 支持直接书写 HTML。注意,在块级 HTML 标签内,Markdown 语法通常不生效(即不会被解析),但在行内元素中可能会被解析。
译注:以上内容为对原 Markdown 教程文档的翻译与精简。
部分信息可能已经过时









