Markdown简单教程

十月 25, 2020 3052

本文作为 Markdown基础语法教程，同时作为个人笔记 &练习。使用 Typora工具，语法可能略有不同，以实际平台为准

标题

Markdown标题有两种格式

使用 = 和 - 标记一级和二级标签

语法如下：

1
2
3
4
5
一级标题
=====

二级标题
-----

效果如下：

使用#号标记

语法如下：

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

注意：#号后面要加一个空格

段落

换行：使用shift+enter键换行。

换段：Markdown的段落要求前后保留一个空行，Typora编辑器直接回车即可，或者先换行再加一个空行，表示更换段落。

两个或以上的空格+shift+enter，实现段内强制换行（行尾有↓箭头）。

字体格式

字体格式：

1
2
3
4
5
6
*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___

显示效果如下：
斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本

列表

Markdown支持无序列表和有序列表。

无序列表：

无序列表有三种写法，+ 或-或*后加空格即可：

1
2
3
+ 第一项
* 第一项
- 第一项

显示效果：

有序列表

有序列表使用数字和.再加上空格即可：

1
2
3
1. 第一项
2. 第二项
3. 第三项

显示效果：

列表嵌套

列表嵌套需要在子列表选项前加四个空格：

1
2
3
4
5
6
1. 第一项：
    - 第一项的第一个元素
    - 第一项的第二个元素
2. 第二项：
    - 第二项的第一个元素
    - 第二项的第二个元素

显示效果：

Typora中，子列表选项前不加空格也可以。

插入区块和分隔线

区块

Markdown的区块引用是在段落开头使用> 号和空格：

1
> 区块引用

显示效果：

另外，区块引用也可以像列表一样嵌套，一个> 表示第一层，两个> 表示第二层，以此类推：

1
2
3
> 第一层
>> 第二层
>>> 第三层

区块中也可以使用列表，同样，列表中也可以使用区块。

分隔线

在一个空行中，使用三个或以上的*、+、-、_来创建分隔线：

1
2
3
4
***
++++
-----
______

插入代码

句中代码

如果是句中的代码片段或函数，只需要一对反引号` 即可 (位于Tab键上面):

1
`printf()`函数

显示效果：

pringf()函数

代码块

代码块需要两个以上反引号，可以指定语言，以下为python语言的代码块：

1
2
3
4
​```
def main():
	print('hello world')
​```

显示效果：

1
2
def main():
	print('hello world')

还可以使用缩进式方法，使用四个空格或者一个制表符(Tab键)，一段代码会持续到没有缩进的那一行

插入链接和图片

插入链接

插入链接有两种方法：

1
[链接名称](链接地址)

或者：

1
<链接地址>

例如：
方法一：github
方法二：https://github.com/

插入图片

插入图片的方法与插入链接的方法区别在于，插入图片的语法前加!号：

1
![属性名称](图片地址)

还可以使用标签，用来指定图片大小：

1
<img src="图片地址" width="80%"

Markdown需要以链接的形式插入图片，如果md文件发布到网站，则链接可能会失效，所以建议使用图床保存图片，这样无论md文件在哪里，只要链接不失效，就可以看到图片。

高级链接

可以通过变量来设置一个链接，在文档末尾为变量赋值：

1
2
3
4
网址链接[链接名称][1]
插入图片![][2]
[1]:https://github.com/
[2]:https://www.google.com.hk/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png

插入表格

Markdown制作表格使用| 来分隔不同的单元格，使用-分隔表头和其他行，代码如下：

1
2
3
4
| 表头 | 表头|
| --- | ---|
|单元格|单元格|
|单元格|单元格|

效果如下：

表头 表头
单元格 单元格
单元格 单元格

对齐方式 ：

  • -:设置内容和标题栏居右对齐
  • :-设置内容和标题栏居左对齐
  • :-:设置内容和标题栏居中对齐

代码如下：

1
2
3
4
|左对齐|右对齐|居中对齐|
|：---|---：|：----：|
|单元格|单元格|单元格|
|单元格|单元格|单元格|

效果如下：

左对齐 右对齐 居中对齐
单元格 单元格 单元格
单元格 单元格 单元格

HTML元素

Markdown支持部分html标签，比如：<kbd>、<b>、<i>、<em>、<sup>、<sub>、<br>，以及<fond>等html标签：

1
2
使用 <kbd>Ctrl</kbd>+<kbd>c</kbd> 复制
<font color="red" size=5>我是红色字体,大小为</font>

效果如下：

使用 Ctrl+c 复制

我是红色字体,大小为5

其他

页内跳转

使用页内跳转可以用来进行引用等功能的快速跳转。

具体实现方法：

  1. 定义锚点(id)：在跳转到的目标处添加<span>标签或者<div>标签，比如<span id="refer-1">参考链接1</span>
  2. 使用Markdown语法：在想要跳转的地点，使用[点击跳转](#refer-1)语句，如果想要“点击跳转”内容是上标的形式，可以将其放到<sup>标签中，即[<sup>点击跳转</sup>](#refer-1)

转义

使用\符号转移特殊字符：

1
2
**文本加粗**
\*\*正常显示星号\*\*

效果如下：

文本加粗
**正常显示星号**

插入公式

使用两个美元符号$$$$将TeX或LaTeX格式的数字公式包裹，即可插入公式：

更多Markdown公式表示方法参考：Cmd Markdown公式指导手册

1
2
3
$
\sqrt{ {x^2}+{y^2} }+v_1+v_2
$

效果如下：

\sqrt{ {x^2}+{y^2} }+v_1+v_2

插入流程图

Typora插入横向流程图：

1
2
3
4
5
6
7
8
​```mermaid
graph LR
A[方形] -->B(圆角)
    B --> C{条件a}
    C -->|a=1| D[结果1]
    C -->|a=2| E[结果2]
    F[横向流程图]
​```

效果如下：

6

更多类型的流程图、顺序图等可以参考：typora画流程图、时序图(顺序图)、甘特图

参考链接

查看评论