Markdown 用法要点
一、什么是 Markdown?
Markdown 是一种轻量级标记语言,由约翰.格鲁伯(John Gruber)于 2004 年设计,核心目标是 “用简单的语法实现易写易读的文本格式化”—— 无需像 Word 那样依赖鼠标操作格式,
仅通过少量符号(如 #、*、[]())就能快速定义标题、列表、链接等样式,最终可导出为 HTML、PDF、文档等格式。
它的核心优势:
简洁性:语法极简,5 分钟可上手,无需记忆复杂操作;
兼容性:几乎所有笔记工具(如 Notion、Typora)、代码平台(如 GitHub、GitLab)、博客系统(如 WordPress)都支持;
纯文本特性:文件体积小,可跨设备编辑,不依赖特定软件。
二、核心用法(常用语法速查)
1. 标题(层级 1-6 级)
用 # 开头,# 数量对应标题层级(1 级最多,6 级最少),# 后需加空格。
语法格式 效果预览
# 一级标题 # 一级标题
## 二级标题 ## 二级标题
### 三级标题 ### 三级标题
... ...
###### 六级标题 ###### 六级标题
注意:标题层级建议不超过 4 级,避免文档结构过深。
2. 文本格式(加粗、斜体、删除线)
通过符号包裹文本实现基础样式,支持组合使用。
语法格式:
*斜体文本* 或 _斜体文本_
**加粗文本** 或 __加粗文本__
***加粗斜体*** 加粗斜体
~~删除线文本~~ 删除线文本
3. 列表(有序、无序、嵌套)
(1)无序列表
用 *、+ 或 - 开头,符号后加空格。
markdown:
- 无序列表项1
- 无序列表项2
- 嵌套子项(前加 2 个空格)
- 嵌套子项
(2)有序列表
用「数字 +.」开头,. 后加空格(数字无需手动排序,工具会自动修正)。
markdown:
1. 有序列表项1
2. 有序列表项2
4.表格
markdown:
| 列1 | 列2 | 列3 |
|-----|-----|-----|
| 内容 | 内容 | 内容 |
5.代码块
markdown:
```python
def hello():
print("Hello World")
```
三.示例
1.markdown:
# 项目报告
## 概述
本项目旨在**提高工作效率**。
## 功能列表
- 自动化处理
- 数据导出
- 报告生成
## 代码示例
```python
import pandas as pd
data = pd.read_csv("file.csv")
```
## 表格
| 列1 | 列2 | 列3 |
|-----|-----|-----|
| 内容 | 内容 | 内容 |
2.显示效果: