markdown语法备忘录
2025-07-24 14:29:24 #memo

Markdown 是一种轻量级标记语言，语法简洁直观，广泛用于文档编写、笔记、博客等场景。以下是常用的 Markdown 语法全解析，包含基础格式、进阶用法及扩展功能：

markdow 常用语法

一、标题

通过 # 号表示，# 数量对应标题级别（1-6 级），# 后需加空格。

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

二、文本格式

1. 基础强调

  • 加粗：用 ** 或 __ 包裹文本

    1
    2
    **这是加粗文本**  
    __这也是加粗文本__

    效果：这是加粗文本

  • 斜体：用 * 或 _ 包裹文本 

    1
    2
    *这是斜体文本*  
    _这也是斜体文本_

    效果：这是斜体文本

  • 加粗+斜体：组合使用 *** 或 ___ 

    1
    2
    ***加粗斜体文本***  
    ___加粗斜体文本___

    效果：加粗斜体文本

  • 删除线：用 ~~ 包裹文本 

    1
    ~~这是删除线文本~~

    效果：这是删除线文本

  • 下划线：用 <u> 标签（部分编辑器支持，非标准语法） 

    1
    <u>这是下划线文本</u>

    效果：这是下划线文本

2. 高亮（扩展语法）

部分编辑器（如 Typora、GitHub）支持用 == 包裹文本实现高亮： 

1
==这是高亮文本==

效果：==这是高亮文本==

三、列表

1. 有序列表

用数字 + . + 空格开头，序号无需手动排序，Markdown 会自动校正： 

1
2
3
4
5
1. 第一项
2. 第二项
   1. 子项1（缩进2-4个空格或1个Tab）
   2. 子项2
3. 第三项

效果：

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

2. 无序列表

用 -、+ 或 * + 空格开头，符号可混用： 

1
2
3
4
- 项目1
+ 项目2
* 项目3
  - 子项目3.1（缩进）

效果：

  • 项目1
  • 项目2
  • 项目3
    • 子项目3.1

3. 任务列表（扩展语法）

用 - [ ] 表示未完成，- [x] 表示已完成（x 不区分大小写）： 

1
2
3
- [x] 完成Markdown语法学习
- [ ] 练习实际案例
- [ ] 总结笔记

效果：

  • 完成Markdown语法学习
  • 练习实际案例
  • 总结笔记

四、引用

用 > 表示引用，可嵌套多层（每层加一个 >）： 

1
2
3
4
5
> 一级引用
>> 二级引用（嵌套）
>>> 三级引用
> 
> 回到一级引用（空行分隔）

效果：

一级引用

二级引用（嵌套）

三级引用

回到一级引用

五、代码块

1. 行内代码

用 `（反引号）包裹单行代码： 

1
打印语句：`print("Hello World")`

效果：打印语句：print("Hello World")

2. 多行代码块

用 ``` 包裹，可指定语言（实现语法高亮）： 

1
2
3
4
def hello():
    print("Hello Markdown")

hello()

六、链接

1. 基础链接

格式：[显示文本](链接地址 "可选标题")（标题在 hover 时显示） 

1
[GitHub](https://github.com "代码托管平台")

效果：GitHub

2. 引用式链接

先定义链接标识，再引用（适合多次复用同一链接）： 

1
2
3
这是[示例链接][1]，这是[重复链接][1]。

[1]: https://example.com "示例网站"

效果：
这是示例链接，这是重复链接。

3. 锚点链接

用于跳转到文档内指定位置（需目标位置有标题）： 

1
跳转到[标题部分](#一、标题)

效果：跳转到标题部分（注：部分平台对锚点支持不同，可能需要小写或替换空格为 -）

七、图片

语法与链接类似，前面多一个 !： 

1
![图片alt文本](图片地址 "可选标题")

示例： 

1
![示例图片](https://picsum.photos/200/150 "随机图片")

效果：
示例图片

注：本地图片需放在项目目录（如 images/），路径写相对地址（如 ./images/pic.jpg）。

八、表格

用 | 分隔列，- 表示表头与内容分隔，: 控制对齐方式： 

1
2
3
4
| 姓名 | 年龄 | 职业 |
| :--- | :--: | ---: |  # 左对齐 | 居中 | 右对齐
| 张三 | 25   | 程序员 |
| 李四 | 30   | 设计师 |

效果：

姓名 年龄 职业
张三 25 程序员
李四 30 设计师

九、分割线

用 ---、*** 或 ___（至少3个字符，前后空行）： 

1
2
3
---
***
___

十、脚注（扩展语法）

用于添加补充说明，自动在文末生成编号和内容：

1
2
3
这是需要注释的文本[^1]。

[^1]: 这是脚注的具体内容。

效果：
这是需要注释的文本^1。

十一、数学公式（扩展语法）

需编辑器支持（如 Typora、GitHub 部分支持），用 $ 包裹：

  • 行内公式：$E=mc^2$
    效果：$E=mc^2$

  • 块级公式：$$公式$$ 

    1
    2
    3
    $$
    \sum_{i=1}^n i = \frac{n(n+1)}{2}
    $$

    效果：
    $$
    \sum_{i=1}^n i = \frac{n(n+1)}{2}
    $$

十二、特殊符号

  • 反斜杠 \：转义特殊字符（如 \* 显示为 *，而非斜体）
  • 空格：连续空格默认合并，如需强制空格，用 &nbsp;（HTML 实体）
  • 换行：单行末尾加两个空格 + 回车，或直接空一行

常用工具推荐

  • 编辑器：Typora（实时预览）、VS Code（配插件）、MarkText
  • 在线工具：StackEdit、Markdown Here
  • 平台支持：GitHub、知乎、掘金、语雀等均原生支持 Markdown

掌握这些语法，即可满足绝大多数文档编写需求。不同平台对扩展语法（如高亮、脚注）的支持可能有差异，实际使用时可根据工具特性调整。

Prev
2025-07-24 14:29:24 #memo
Next