Markdown语法教程
本文最后更新于 2024-07-11，文章内容可能已经过时。
什么是Markdown？
- *Markdown是一种轻量级标记语言，它于2004年被约翰·格鲁伯(John Gruber)创建。
- Markdown编写的文档可以导出为Html、Word、图像、PDF、Epub等多种格式的文档
- Markdown的后缀名通常为“.md”".markdown"
- Markdown的排版语法简洁，让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档，可与HTML混编，可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写，Markdown被大量使用，如Github、Wikipedia、简书等。
如何使用Markdown编写？
Markdown可以使用对Markdown支持的编辑器进行编写
下面我会列出几个Markdown的编辑器，但不对其价格、实用性、美观性做出评价
- ......
了解Markdown的语法
Markdown标题语法
Markdown的标题有一级(#)和六级(######),和Html中的一级到六级有异曲同工之妙。
- 这是Markdown的一级
# 一级
也就是
一级
- 而Html中的一级则为
<h1>一级</h1>
也就是
一级
以此类推，Markdown的一级到六级是“#”的增加，而Html中的一级到六级是数
字的增加，如
<h1>一级</h1>
<h2>二级</h2>
......
除了这些方法，还可以在文本下方增加任意数量的 == 来标识一级标题，如：
一级
==================
在文本下方增加任意数量的 -- 来标识二级标题，如
二级
---------------
注意：
不同的Markdown编辑器/平台在处理 # 和标题之间的空格方式并不一致，为了兼容性考虑，请在 # 和 标题之间加一个空格，如
# 这是标题
而不要编辑成
#这是标题
Markdown段落
要创建段落，请使用空白行将一行或多行文本进行分隔。
就比如
今天，阳光明媚
昨天，乌云密布
不要用空格（spaces）或制表符（ tabs）缩进段落。
在一段文字开始之前不要有空缩进
Markdown换行语法
在一行的末尾添加两个或多个空格，然后按回车键,即可创建一个换行(<br>)。
Markdown 强调语法
通过将文本设置为粗体或斜体来强调其重要性。
粗体
要加粗文字可以按以下两种方法
- 在需要加粗的文字的左右两边加“**”
**加粗**
加粗
2. (不建议)在需要加粗的文字的左右两边加“__”
__加粗__
不推荐使用第二种方法，因为Markdown 应用程序在如何处理单词或短语中间的下划线上并不一致，所以为兼容考虑，在单词或短语中间部分加粗的话，请使用星号（asterisks）。
斜体
- 在需要改斜体的文字的左右两边加“**”
*加粗*
加粗
2. (不建议)在需要改斜体的文字的左右两边加“__”
_加粗_
不推荐使用第二种方法，因为Markdown 应用程序在如何处理单词或短语中间的下划线上并不一致，所以为兼容考虑，在单词或短语中间部分改斜体的话，请使用星号（asterisks）。
粗体和斜体
斜体
- 在需要加粗体并改斜体的文字的左右两边加“**”
*加粗*
加粗
2. (不建议)在需要加粗体和改斜体的文字的左右两边加“__”
_加粗_
不推荐使用第二种方法，因为Markdown 应用程序在如何处理单词或短语中间的下划线上并不一致，所以为兼容考虑，在单词或短语中间部分加粗和改斜体的话，请使用星号（asterisks）。
引用
在需要引用的文字前加上">"
如：
> 引用
嵌套引用，就像
>引用
>>嵌套引用
带着其他元素引用，就像
>### 三级标题
>* 1
>* 2
>**粗体**
>*斜体*
>***粗体和斜体***
列表语法
有序列表
如
1. 一
2. 二
3. 三
1. 一
8. 二
3. 三
10. 四
1. 一
2. 二
3. 三
1. 三点一
2. 三点二
4. 四
5. 五
为了兼容性，请不要这样子
1) a
2) b
应该要这样子
1. a
2. b
无序列表
要创建无序列表，请在每个列表项前面添加破折号、星号 或加号
- a
- bx
- cs
- da
- ea
* a
* b
* e
* c
* a
+ 1
+ 5
+ 8
+ 2
+ 3
- 2
- 3
- 2
- 5
- 4
- 5
- a
- b
- c
- ca
- cb
- f
- y
为了你的文章的兼容性
请不要这样做
- a
+ b
* 5
+ 4
嵌套的注意事项：
要在保留列表连续性的同时在列表中添加另一种元素，请将该元素缩进四个空格或一个制表符（tab），如下图所示：
详细信息请前往这里查看：Markdown 列表语法 |Markdown 官方教程
代码语法
要将单词或短语表示为代码，请将其包裹在反引号 (`) 中。
如：
这是`代码`
这是代码
代码块
要创建代码块，请将代码块的每一行缩进至少四个空格或一个制表符。
或者使用围栏式代码块（fenced code blocks）.
这是代码
Markdown 分隔线语法
要创建分隔线，请在单独一行上使用三个或多个星号 (***)、破折号 (---) 或下划线 (___) ，并且不能包含其他内容。
如：
就像这样
上
下
Markdown 链接语法
如这样子：
[星途语梦](https://www.chacks.top)
效果如下：
星途语梦
给链接增加 Title
链接title是当鼠标悬停在链接上时会出现的文字，这个title是可选的，它放在圆括号中链接地址后面，跟链接地址之间以空格分隔。
[星途语梦](https://www.chacks.top "星途语梦，梦漫征途")
网址和Email地址
使用尖括号可以很方便地把URL或者email地址变成可点击的链接。
<https://www.chacks.top>
<chacks.top@foxmail.com>
效果如下：
https://www.chacks.top
chacks.top@foxmail.com
带格式化的链接
强调 链接, 在链接语法前后增加星号。 要将链接表示为代码，请在方括号中添加反引号。
I love supporting the **[EFF](https://eff.org)**.
This is the *[Markdown Guide](https://www.markdownguide.org)*.
See the section on [`code`](#code).
渲染效果如下：
I love supporting the EFF.
This is the Markdown Guide.
See the section on code.
更多请前往Markdown查看
Markdown 图片语法
可以增加提示
也可以增加跳转
[](跳转链接)
Markdown转义字符
Markdown 转义字符语法 | Markdown 官方教程
Markdown 内嵌 HTML 标签
Markdown 内嵌 HTML 标签 | Markdown 官方教程
文章内容声明
参考资料
Markdown 官方教程
Markdown 教程 | 菜鸟教程 (runoob.com)
若你觉得本文侵害了你的权益，请通过邮箱chacks.top@foxmail.com与我联络，或者在文章底部评论区与我联络，谢谢合作！
