一、Markdown 简介
Markdown 是一种轻量级标记语言,由约翰·格鲁伯(John Gruber)和亚伦·斯沃茨(Aaron Swartz)创建于 2004 年。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML(或者 HTML)文档。Markdown 的语法简洁明了,易于学习和使用,广泛应用于文档写作、博客、论坛等场景。
二、Markdown 基本语法
1. 标题
使用 #
来表示标题,#
的数量代表标题的级别。
# 一级标题
:一级标题通常是文档的主标题,字体较大且突出。## 二级标题
:二级标题是文档的主要章节标题。### 三级标题
:三级标题用于更细分的章节。
以此类推,最多可以有六级标题。标题有助于组织文档结构,使读者能够快速了解文档的大纲。
2. 段落
段落之间用空行分隔。如果要强制换行,可以在行末使用两个或以上的空格,然后按下回车键。保持段落清晰有助于提高文档的可读性。
3. 强调
- 加粗:使用两个
*
或两个_
包裹要加粗的文本,例如**这是加粗的文本**
或__这是加粗的文本__
。加粗可以用来突出重要的词语或句子。 - 斜体:使用一个
*
或一个_
包裹要斜体的文本,例如*这是斜体的文本*
或_这是斜体的文本_
。斜体通常用于强调特定的词汇或表示引用的内容。 - 既加粗又斜体:使用三个
*
或三个_
包裹要既加粗又斜体的文本,例如***这是既加粗又斜体的文本***
或___这是既加粗又斜体的文本___
。这种强调方式可以用于特别重要或需要引起读者高度注意的内容。
4. 列表
- 无序列表:使用
-
、*
或+
开头,后面跟一个空格和列表项内容。- 列表项 1
:无序列表适用于列举没有特定顺序的项目。- 列表项 2
:可以根据需要创建多个列表项。- 列表项 3
:每个列表项独占一行,使文档更加整洁。
- 有序列表:使用数字加
.
开头,后面跟一个空格和列表项内容。- 列表项 1:有序列表适用于需要按照特定顺序排列的项目。
- 列表项 2:数字会自动递增,方便读者跟踪进度。
- 列表项 3:可以嵌套其他列表,以创建更复杂的结构。
5. 引用
使用 >
来表示引用。
这是一段引用的内容。引用通常用于引用他人的话语、文献或观点。可以嵌套引用,如下所示:
这是一级引用。这是二级引用。嵌套引用可以用于展示对话或多层次的引用关系。
6. 链接
- 行内式链接:
[链接文本](链接地址)
,例如[百度](https://www.baidu.com)
。链接文本是用户在文档中看到的可点击内容,链接地址是指向目标页面的 URL。 - 参考式链接:先在文档中任意位置定义链接的引用,然后在需要使用链接的地方使用引用的标签。
- 定义链接引用:
[链接标签]: 链接地址
,例如[baidu]: https://www.baidu.com
。链接标签可以是任何你喜欢的名称,但要确保在文档中唯一。 - 使用链接引用:
[链接文本][链接标签]
,例如[百度][baidu]
。参考式链接可以使文档更加整洁,尤其是当有多个相同链接时,只需定义一次引用即可。
- 定义链接引用:
7. 图片
- 行内式图片:

,例如
。图片替代文本在图片无法加载时显示,同时也有助于提高文档的可访问性。 - 参考式图片:与参考式链接类似,先定义图片引用,然后在需要使用图片的地方使用引用的标签。
- 定义图片引用:
[图片标签]: 图片地址
,例如[image]: https://example.com/image.jpg
。 - 使用图片引用:
![图片替代文本][图片标签]
,例如![美丽的风景][image]
。
- 定义图片引用:
8. 代码
- 行内代码:使用反引号 (
) 包裹代码,例如
这是一段行内代码`。行内代码适用于插入少量的代码片段,如变量名、函数调用等。 - 代码块:使用三个反引号(```)包裹代码块,并可以在开头的反引号后面指定代码的语言,以便进行语法高亮显示。
print("Hello, Markdown!")
代码块可以用于展示较长的代码片段,语法高亮可以使代码更加易读。
三、Markdown 高级语法
1. 表格
表格在 Markdown 中不仅可以用于简单的数据展示,还可以进行更加复杂的排版。例如,可以使用不同的分隔符来创建独特的表格样式。同时,可以在表格中插入链接和图片,使表格内容更加丰富。
列 1 | 列 2 | 列 3 |
---|---|---|
[链接文本 1](链接地址 1) | 内容 2 |  |
内容 4 | [链接文本 2](链接地址 2) |  |
内容 6 | 内容 7 | [链接文本 3](链接地址 3) |
此外,还可以通过添加表格标题和注释来进一步说明表格内容。使用 caption
标签来添加表格标题,使用 <p>
标签来添加表格注释。
列 1 | 列 2 | 列 3 |
---|---|---|
内容 1 | 内容 2 | 内容 3 |
内容 4 | 内容 5 | 内容 6 |
这是表格注释。
2. 任务列表
任务列表除了用于记录待办事项和进度跟踪外,还可以进行分组和排序。可以使用不同的符号来表示不同的任务类型,例如 - [ ]
表示普通任务,- [*]
表示重要任务,- [!]
表示紧急任务。
- 普通任务 1
- [*] 重要任务 2
- [!] 紧急任务 3
3. 分割线
分割线不仅可以用于分隔不同的部分,还可以作为文档的装饰元素。可以使用不同的符号和长度来创建各种分割线样式。例如,使用多个连续的 =
可以创建一条粗实线分割线,使用多个连续的 -
可以创建一条细实线分割线,使用多个连续的 *
可以创建一条虚线分割线。
======
此外,还可以在分割线上添加文本或图标,使分割线更加个性化。例如,可以在分割线上添加标题或日期,或者使用图标来代替传统的分割线符号。
日期:2024 年 8 月 19 日
图标分割线
4. 脚注
脚注可以用于提供额外的解释或参考信息,使文档更加严谨和专业。除了在文档末尾添加脚注内容外,还可以在脚注中添加链接、图片或其他 Markdown 元素。
这是一段带有脚注的文本1。
同时,可以使用多个脚注来引用同一处内容,或者在脚注中引用其他脚注,形成脚注的嵌套结构。
5. 数学公式
Markdown 支持使用 LaTeX 语法来插入数学公式。可以使用 $
包裹行内公式,使用 $$
包裹块级公式。
例如,行内公式 $E = mc^2$ 表示能量等于质量乘以光速的平方。块级公式:
$$ \sum_{i=1}^{n} i = \frac{n(n + 1)}{2} $$
表示从 1 到 n 的整数求和公式。
可以使用各种数学符号和运算符来创建复杂的数学公式,例如积分、微分、矩阵等。
6. 链接和图片的高级用法
- 链接可以使用标题属性来提供链接的描述信息,当鼠标悬停在链接上时会显示标题内容。例如,
[链接文本](链接地址 "标题内容")
。
- 图片可以使用宽度和高度属性来调整图片的大小,例如,

。

同时,可以使用图片的标题属性来提供图片的描述信息,当鼠标悬停在图片上时会显示标题内容。

四、Markdown 工具推荐
1. Typora
一款简洁美观的 Markdown 编辑器,支持实时预览。Typora 的界面简洁,操作方便,能够让你专注于写作。它支持多种主题和字体,可以根据个人喜好进行定制。同时,Typora 还支持导出为多种格式,如 PDF、HTML 等。
2. Visual Studio Code
功能强大的代码编辑器,通过安装插件可以很好地支持 Markdown 编辑。Visual Studio Code 具有丰富的功能,如代码高亮、自动补全、调试等。安装 Markdown 插件后,可以实时预览 Markdown 文档,并提供了许多方便的编辑功能。
3. MarkdownPad
Windows 平台上的 Markdown 编辑器。MarkdownPad 具有直观的界面和丰富的功能,支持实时预览、自定义主题、快捷键等。它还支持导出为 HTML、PDF 等格式。
五、总结
Markdown 是一种非常实用的标记语言,它可以让你专注于内容的创作,而不必担心排版的问题。通过掌握 Markdown 的基本语法和高级语法,你可以轻松地编写清晰、易读的文档。同时,配合合适的 Markdown 工具,可以提高你的工作效率。希望这份教程对你有所帮助!无论是撰写博客、技术文档还是学术论文,Markdown 都是一个不错的选择。