Markdown 标题完整用法（2025 最新规范）

Markdown 标题主要有两种写法：Setext 风格 和 atx 风格。
现在最常用的是 atx 风格（用 #）。

1. atx 风格（推荐，几乎所有地方都支持）

# 一级标题（H1）
## 二级标题（H2）
### 三级标题（H3）
#### 四级标题（H4）
##### 五级标题（H5）
###### 六级标题（H6）

效果：

一级标题（H1）

二级标题（H2）

三级标题（H3）

四级标题（H4）

五级标题（H5）

六级标题（H6）

小技巧：

• 在 # 后面和文字前面加空格更标准（大多数编辑器不加也行）
• 在行尾加 # 是合法的（可以两边对齐，看着整齐）：

  ## 这是一个二级标题 ##
  ### 这是一个三级标题 ###

2. Setext 风格（老风格，只有两级，现在很少用）

一级标题（H1）
===============

二级标题（H2）
---------------

3. 标题最佳实践（2025 推荐写法）

# 项目名称（一级只出现一次，最好是文档名字）

## 功能特性        <-- 二级用来分大章节
### 快速开始       <-- 三级用来分小节
#### 安装步骤     <-- 四级尽量少用
##### Windows 系统
##### macOS 系统

## 常见问题（FAQ）

## 参考文献

4. 不同平台的特殊支持（GFM 扩展）

平台	特殊功能	示例
GitHub	支持标题锚点自动生成	## 我的标题 → 链接是 #我的标题
语雀、Notion	支持标题折叠	自动可折叠
Obsidian	支持标题别名（双向链接用）	## 标题别名 {{alias: 别名1, 别名2}}
Typora	支持目录自动生成（TOC）	[TOC] 或 [toc] 自动生成目录
VS Code	Ctrl+Click 标题可快速跳转	内置支持

5. 超实用模板（直接复制就能用）

# 我的项目/笔记/简历

## 📖 简介

## 🚀 快速开始

### 环境要求

### 安装步骤

## 📝 使用说明

## ⚙️ 配置项

## ❓ 常见问题

## ❤️ 致谢

现在你已经完全掌握 Markdown 标题了！
记住核心原则：一级标题只用一次，二级分大章，三级分小节，四级以上尽量少用，这样文档结构最清晰。

想要我给你一套超漂亮的博客/简历/技术文档标题模板吗？直接说～我这有 10+ 套现成的 😎