Markdown 快速入门指南

一篇写给初学者的 Markdown 语法速成手册。跟着读一遍,再动手敲一遍,半小时就能上手。

一、Markdown 是什么

Markdown 是一种轻量级标记语言,用简单的符号(#*- 等)标注文字结构,让纯文本既好读、又好排版。写完后可以一键转换成网页(HTML)、PDF、Word 等格式。

它的核心思想只有一句话:用最少的符号,写最干净的文档。

二、标题

标题用 # 表示,# 越多,级别越低。一个 # 是一级标题,最多支持六级。

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

小提示:# 后面要加一个空格再写字,这是很多新手最容易踩的坑。

三、段落与换行

段落之间用空行分隔。普通换行不会产生新段落,只会被视为空格。

这是第一段。

这是第二段,和第一段之间隔了一个空行。

如果要在段内强制换行,在行尾加两个空格再回车:

第一行。··
第二行(行尾有两个空格,见上文"··"处)

四、强调

效果 语法 示例
粗体 **文字**__文字__ 这是粗体
斜体 *文字*_文字_ 这是斜体
粗斜体 ***文字*** 这是粗斜体
删除线 ~~文字~~ ~~这是删除线~~

五、列表

无序列表用 -*+,有序列表用数字加点:

- 苹果
- 香蕉
- 橘子

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

嵌套列表只需在子项前缩进两个空格(或一个 Tab):

- 一级项目
  - 二级项目
    - 三级项目

任务列表(部分编辑器支持)用 - [ ]- [x]

- [x] 已完成的项
- [ ] 待办事项

六、链接与图片

链接语法:[文字](网址),图片语法比链接多一个 !

[访问必应](https://www.bing.com)

![图片描述](https://example.com/pic.png)

还有更高级的引用式写法,把链接地址集中放在文末,正文更干净:

[必应][1]

[1]: https://www.bing.com

七、行内代码与代码块

一句话里提到命令、文件名时,用反引号包起来:

运行 `npm install` 即可安装依赖。

多行代码用三个反引号包裹,并可以标注语言,获得语法高亮:

def hello(name):
    print(f"你好,{name}!")

hello("Markdown")

八、引用

行首加 > 表示引用,可以多层嵌套:

> 这是引用。
> 
> > 这是嵌套的引用。

九、表格

表格用竖线 | 分隔列,第二行用 ---: 指定对齐方式:

| 左对齐 | 居中 | 右对齐 |
| :--- | :---: | ---: |
| 甲 | 乙 | 丙 |
| 丁 | 戊 | 己 |

渲染效果如下:

左对齐 居中 右对齐

十、分隔线

单独一行写三个及以上的 -*_,就是一条水平分隔线:

---

***

___

十一、转义字符

想显示 Markdown 符号本身时,在符号前加反斜杠 \

\# 这不是标题
\* 这不是列表

十二、快速上手建议

  1. 先找个趁手的编辑器:Typora、Obsidian、VS Code(装 Markdown 插件)都是好选择。
  2. 边看边敲:本页所有示例都可以复制到编辑器里,看渲染效果。
  3. 从这 8 个语法开始:标题、粗体、列表、链接、图片、代码块、引用、表格——日常 90% 的场景都够用了。
  4. 写坏了不怕:Markdown 是纯文本,任何时候都能改回来,没有格式锁死的问题。

十三、语法速查表

语法 作用
# 标题(1~6 级)
**粗** 粗体
*斜* 斜体
~~删~~ 删除线
- 项 无序列表
1. 项 有序列表
[文字](网址) 链接
![描述](网址) 图片
`代码` 行内代码
```语言 代码块
> 引用 引用
\| 列 \| 列 \| 表格
--- 分隔线
\符号 转义

祝写作愉快 ❖ 坚持用 Markdown 写笔记,三个月后你会感谢现在的自己。