Markdown 是轻量级标记语言,语法简单且跨平台通用(几乎所有笔记 / 文档工具都支持),且是现在AI提示词的主流格式,以下是通用标准语法(不含各平台扩展语法):
1. 标题
用#表示标题级别,#数量对应 1-6 级标题,#和文字之间必须加空格(新手易出错)。
markdown
shell
# 一级标题(最大)
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题(最小)
日常使用中 1-3 级标题最常用,六级标题几乎很少用到。
2. 文本强调(粗体 / 斜体 / 删除线)
表格
| 效果 | 语法 | 示例 | 渲染效果 |
|---|---|---|---|
| 粗体 | **文字** |
**重要内容** |
重要内容 |
| 斜体 | *文字* |
*备注信息* |
备注信息 |
| 粗斜体 | ***文字*** |
***核心重点*** |
核心重点 |
| 删除线 | ~~文字~~ |
~~作废内容~~ |
3. 列表(无序 / 有序 / 嵌套)
无序列表
用-/+/*开头(选一种即可),符号后加空格:
markdown
markdown
- 列表项1
- 列表项2
- 嵌套子项(缩进2个空格)
+ 另一种无序列表
有序列表
用数字.开头,符号后加空格:
markdown
markdown
1. 第一步
2. 第二步
1. 嵌套子步骤
3. 第三步
4. 链接与图片
链接
-
行内链接(最常用):
[链接文字](链接地址 "可选标题")markdown
less[百度](https://www.baidu.com "百度首页") -
锚点链接(跳转到文档内位置):
[回到顶部](#一级标题)
图片
语法和链接类似,只是开头多一个!:
markdown
less

# 替代文字:图片加载失败时显示的文字;标题:鼠标悬停时显示

5. 代码(行内 / 块级)
行内代码
用单个反引号`````包裹,适合标注少量代码 / 命令:
markdown
css
执行`python main.py`命令启动程序
代码块
用三个反引号 ``` 包裹,指定语言可实现语法高亮:
markdown
scss
```python
# 这是Python代码示例
def hello():
print("Hello Markdown!")
hello()
plaintext
shell
### 6. 引用
用`>`开头,嵌套引用加多个`>`:
```markdown
> 一级引用(比如引用他人观点)
>> 二级嵌套引用
>>> 三级嵌套引用
7. 分割线
用连续的 3 个及以上-/*/_(单独一行,前后空行):
markdown
yaml
---
***
___
⚠️ 注意:不要混写(比如-*-),保持统一更规范。
8. 表格
用|分隔列,第二行用-分隔表头和内容,:控制对齐:
markdown
ruby
| 姓名 | 年龄 | 城市 |
| :--- | :--: | ---: |
| 张三 | 20 | 北京 |
| 李四 | 25 | 上海 |
# 对齐规则::---(左对齐)、:--:(居中)、---:(右对齐)
9. 转义字符
如果想显示 Markdown 特殊符号(比如#/*/[ ]),用``转义:
markdown
markdown
# 这不是标题(原本#是标题符号,转义后仅显示#)
* 这不是斜体
总结
- Markdown 核心是 "符号 + 空格" 的组合,符号与文字间的空格是新手最容易忽略的关键;
- 常用语法优先掌握:标题、粗体 / 斜体、列表、代码块、链接,能满足 80% 的日常使用场景;
- 标准语法跨平台通用(如 Typora、VS Code、GitHub),扩展语法(如任务列表)需看编辑器支持。