markdown基础语法（使用教程）

Table of Contents generated with DocToc

• Markdown 使用教程
  • 标题
  • 段落格式
    • 换行与换段
    • 字体
    • 分割线
    • 删除线
    • 下划线
    • 脚注
  • 列表
    • 无序列表
    • 有序列表
    • 列表嵌套
  • 区块
    • 区块
    • 区块嵌套
    • 区块嵌套列表
  • 代码
    • 代码片段
    • 代码区块
  • 链接
    • 简单链接
    • 高级链接
  • 图片
  • 表格
  • 其他
    • 支持html元素
    • 转义
    • 公式
  • 补充
    • 目录的自动生成

Markdown 使用教程

标题

• 方式一(只有一二级标题)

    1223
  =========
  
  122314
  ---------
  

  

• 方式二(更加常用）

  # 一级标题
  
  ## 二级标题
  
  ### 三级标题
  
  #### 四级标题
  
  ##### 五级标题
  
  ###### 六级标题
  

  

段落格式

换行与换段

• 换行

  段落的换行是使用两个以上空格加上回车

  在typora中分为两种

  1. 软换行

     软换行只在编辑界面可见，当文档被导出时换行会被省略。

     Shift + Enter 完成一次软换行

  2. 硬换行

     通过 空格 + 空格 + Shift + Enter 完成一次硬换行，而这也是许多 Markdown 编辑器所原生支持的。硬换行在文档被导出时将被保留，且没有换段的段后距。

  先演示软换行的操作
  注意上一行没有箭头

  现在演示硬换行的操作
  注意上一行后面的箭头符号

• 换段

  在段落后面使用一个空行来表示重新开始一个段落

  在typora中，你可以通过 Enter 完成一次换段。Typora 会自动帮你完成两次 Shift + Enter 的软换行，从而完成一次换段。

  现在演示换段

  注意行的间距，这个宽度是段落间的宽度

• 换行与换段的对比

  

  明显间距不一样

字体

# 使用* - _
**粗体**
*斜体*
***粗斜体***

粗体
斜体
粗斜体

分割线

## 三个以上的*、-、_来建立一个分隔线
***
---
___

---

---

---

删除线

~~删除~~
<u>下划线</u>

删除

下划线

<u>下划线</u>

下划线

脚注

Markdown 脚注的格式如下:

[^要注释的文本]

给这句话注释一下[^r1]
[^r1]:测试一下

给这句话注释一下¹

列表

无序列表

无序列表使用**星号(*)、加号(+)或是减号(-)**作为列表标记，这些标记后面要添加一个空格

* a
* b
* c

• a

• b

• c

有序列表

1. first
2. second

1. first

2. second

列表嵌套

1. first
2. second
   * a
   * b

1. first
2. second
   • a
   • b

区块

区块

>区块

区块

区块嵌套

>第一层
>>第二层

第一层

第二层

区块嵌套列表

>区块中使用列表
>1. 第一项
>2. 第二项

区块中使用列表

1. 第一项
2. 第二项

代码

代码片段

`print("hello world")`

print("hello world")

代码区块

for i in range(10):
	print(i)

for i in range(10):
	print(i)

链接

简单链接

这是一个链接 [Rocklis](https://www.rockli.xyz)

这是一个链接 Rocklis

高级链接

通过变量来设置一个链接，变量赋值在文档末尾进行

这是链接一[link1][lk1]
这是链接二[link2][lk2]

[lk1]:https://www.baidu.com
[lk2]:https://www.rockli.xyz

这是链接一link1
这是链接二link2

图片

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-MukInRMz-1645719096275)(图片地址)]

![图片](markdown使用技巧.assets/微信图片_20220118001210-16457125649492.jpg)

表格

|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |

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

设置表格的对齐方式：

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

| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

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

其他

支持html元素

如常用的，换行

^_等等

<kbd>ctrl</kbd>+<kbd>o</kbd>

ctrl+o

转义

Markdown 使用反斜杠转义特殊字符：

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

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

公式

$$
\begin{Bmatrix}
   a & b \\
   c & d
\end{Bmatrix}
$$

$$\left\{\begin{array}{cc}a& b\\ c& d\end{array}\right\}$$

补充

目录的自动生成

安装doctoc插件

npm i doctoc -g //install 简写 i

使用

• cd md所在的文件目录下
• doctoc 需要生成目录的md文件.md

cd blog/markdown
doctoc first.md

---

1. 测试一下 ↩︎