基础语法
Markdown是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写,Markdown被大量使用,如Github、Wikipedia、简书等。
标题语法
要创建标题,请在单词或短语前面添加井号 (#) 。
一级标题 一个 “ # ” 注意:#后空格一次再输出
两级标题 两个 “ # ”
三级标题 三个 “ # ”
四级标题 四个 “ # ”
五级标题 五个 “ # ”
六级标题 六个 “ # ”
还可以在文本下方添加任意数量的 == 号来标识一级标题,或者 – 号来标识二级标题。
段落语法
要创建段落,请使用空白行将一行或多行文本进行分隔。
I really like using Markdown.
I think I’ll use it to format all of my documents from now on.
换行语法
在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行
强调语法
通过将文本设置为粗体或斜体来强调其重要性。
粗体(Bold)
要加粗文本,请在单词或短语的前后各添加两个星号(asterisks)或下划线(underscores)
如需加粗一个单词或短语的中间部分用以__表示__
强调的话,请在要加粗部分的两侧各添加两个星号(asterisks)
斜体(Italic)
要用斜体显示文本,请在单词或短语前后添加一个星号(asterisk)或下划线(underscore)。要斜体突出单词的中间部分,请在字母前后各添加一个星号,中间不要带空格。
粗体(Bold)和斜体(Italic)
要同时用粗体和斜体突出显示文本,请在单词或短语的前后各添加三个星号或下划线。要加粗并用斜体显示单词或短语的中间部分,请在要突出显示的部分前后各添加三个星号,中间不要带空格。
删除线
要用删除线显示文本,请在单词或短语前后添加两个破折号~~文本~~
~~删除线~~
删除线
引用语法
要创建块引用,请在段落前添加一个 > 符号
Dorothy followed her through many of the beautiful rooms in her castle.
多个段落的块引用
块引用可以包含多个段落。为段落之间的空白行添加一个 > 符号。
Dorothy followed her through many of the beautiful rooms in her castle.
The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
嵌套块引用
块引用可以嵌套。在要嵌套的段落前添加一个 >> 符号。
Dorothy followed her through many of the beautiful rooms in her castle.
The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
带有其它元素的块引用
块引用可以包含其他 Markdown 格式的元素。并非所有元素都可以使用,你需要进行实验以查看哪些元素有效。
The quarterly results look great!
- Revenue was off the chart.
- Profits were higher than ever.
Everything is going according to plan.
列表语法
可以将多个条目组织成有序或无序列表。
有序列表
要创建有序列表,请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列,但是列表应当以数字 1 起始。
效果演示
- First item
- Second item
- Third item
- Fourth item
- First item
- Second item
- Third item
- Fourth item
- First item
- Second item
- Third item
- Fourth item
- First item
- Second item
- Third item
- Indented item
- Indented item
- Fourth item
、
无序列表
要创建无序列表,请在每个列表项前面添加破折号 (-)、星号 () 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。*
效果演示
- First item
- Second item
- Third item
- Fourth item
- First item
- Second item
- Third item
- Fourth item
- First item
- Second item
- Third item
- Fourth item
- First item
- Second item
- Third item
- Indented item
- Indented item
- Fourth item
表格
- 不管是哪种方式,第一行为表头,第二行分隔表头和主体部分,第三行开始每一行为一个表格行。
- 列于列之间用管道符|隔开。原生方式的表格每一行的两边也要有管道符。
- 第二行还可以为不同的列指定对齐方向。默认为左对齐,在-右边加上:就右对齐。
| 表头 | 表头 |
| ---- | ---- |
| 单元格 | 单元格 |
| 单元格 | 单元格 |
显示效果
表头 | 表头 |
---|---|
单元格 | 单元格 |
单元格 | 单元格 |
-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
显示效果
左对齐 | 右对齐 | 居中对齐 |
---|---|---|
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |
代码语法
- 插入行内代码,即插入一个单词或者一句代码的情况,使用
code
这样的形式插入。 - 插入多行代码,可以使用缩进或者“
code “
,具体看示例。
行内代码
要将单词或短语表示为代码,请将其包裹在反引号 (`) 中。
C语言里的函数 scanf()
怎么使用?
转义反引号
如果你要表示为代码的单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在双反引号(``)中。
Use `code` in your Markdown file.
缩进式多行代码
要创建代码块,请将代码块的每一行缩进至少四个空格或一个制表符。
一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。
#include <stdio.h>
int main(void)
{
printf("Hello world\n");
}
Markdown 代码块可声明编程语言类型,实现代码高亮。有的书写规范要求必须声明,
Markdown 编程语言声明可直接使用后缀名
分隔线语法
要创建分隔线,请在单独一行上使用三个或多个星号 (***)、破折号 (—) 或下划线 (___) ,并且不能包含其他内容。
链接语法
链接文本放在中括号内,链接地址放在后面的括号中,链接title可选。
超链接Markdown语法代码:[超链接显示名](超链接地址 "超链接title")
这是我的博客主页 上山的月。
给链接增加 Title
链接title是当鼠标悬停在链接上时会出现的文字,这个title是可选的,它放在圆括号中链接地址后面,跟链接地址之间以空格分隔。
这是我的博客主页 上山的月。
网址和Email地址
使用尖括号可以很方便地把URL或者email地址变成可点击的链接。
https://blog.csdn.net/weixin_51738481?type=blog
shangshandeyue@outlook.com
强调 链接, 在链接语法前后增加星号。 要将链接表示为代码,请在方括号中添加反引号。
图片语法
要添加图像,请使用感叹号 (!), 然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本。
插入图片Markdown语法代码:

不同位置的图片
带尺寸的图片:
宽度确定高度等比例的图片:
高度确定宽度等比例的图片: 
居中的图片:
居中并且带尺寸的图片:
居右的图片:
链接图片
(网址)
转义字符语法
要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符 \ 。
**文本加粗**
\*\* 正常显示星号 \*\*
输出效果
文本加粗
** 正常显示星号 **
公式
Markdown Preview Enhanced 使用 KaTeX 或者 MathJax 来渲染数学表达式。
KaTeX 拥有比 MathJax 更快的性能,但是它却少了很多 MathJax 拥有的特性。你可以查看 KaTeX supported functions/symbols 来了解 KaTeX 支持那些符号和函数。
默认下的分隔符:
$...$ 或者 \(...\) 中的数学表达式将会在行内显示。
$$...$$或者 \[...\] 或者 ```math 中的数学表达式将会在块内显示。
>$$
\begin{Bmatrix}
a & b \\
c & d
\end{Bmatrix}
$$
$$
\begin{CD}
A @>a>> B \\
@VbVV @AAcA \\
C @= D
\end{CD}
$$
输出效果
{ a b c d } \begin{Bmatrix} a & b \\ c & d \end{Bmatrix} {acbd}
A → a B b ↓ ↑ c C = D \begin{CD} A @>a>> B \\ @VbVV @AAcA \\ C @= D \end{CD} Ab↓ ⏐CaB⏐ ↑cD
支持的 HTML 元素
目前支持的 HTML 元素有:<kbd> <b> <i> <em> <sup> <sub> <br> 等 ,如:
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑
输出效果
使用 Ctrl+Alt+Del 重启电脑