#Markdown 标题

标题是文档结构的基础，Markdown 提供了简洁的标题语法，支持六级标题。

#基本语法

使用 # 号创建标题，# 的数量表示标题级别：

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

#标题级别

#一级标题 (H1)

一级标题通常用于文档标题或章节标题：

# 文档标题

#二级标题 (H2)

二级标题用于主要章节：

## 主要章节

#三级标题 (H3)

三级标题用于子章节：

### 子章节

#四级到六级标题

用于更细分的内容层次：

#### 四级标题
##### 五级标题
###### 六级标题

#替代语法

#Setext 风格标题

使用 = 和 - 创建一级和二级标题：

一级标题
========

二级标题
--------

注意： 这种方式只支持一级和二级标题。

#标题最佳实践

#1. 使用空格

在 # 和标题文本之间添加空格：

✅ 推荐
# 标题

❌ 不推荐
#标题

#2. 标题前后空行

标题前后添加空行，提高可读性：

这是一段文字。

## 标题

这是另一段文字。

#3. 保持层级结构

遵循标题层级，不要跳级：

✅ 推荐
# 一级标题
## 二级标题
### 三级标题

❌ 不推荐
# 一级标题
### 三级标题（跳过了二级）

#4. 避免使用过多层级

通常使用 3-4 级标题就足够了：

# 主标题
## 章节
### 小节
#### 细节（可选）

#5. 标题要简洁明了

✅ 推荐
## 安装步骤

❌ 不推荐
## 这是一个非常详细的关于如何安装软件的步骤说明

#标题 ID

某些 Markdown 解析器会自动为标题生成 ID：

## 我的标题

生成的 HTML：

<h2 id="我的标题">我的标题</h2>

#自定义标题 ID

有些解析器支持自定义 ID：

## 我的标题 \{#custom-id}

#标题链接

#创建目录

利用标题 ID 创建文档目录：

## 目录

- [第一章](#第一章)
- [第二章](#第二章)
- [第三章](#第三章)

## 第一章

内容...

## 第二章

内容...

## 第三章

内容...

#链接到标题

跳转到 [安装步骤](#安装步骤)

## 安装步骤

详细步骤...

#标题编号

#手动编号

# 1. 第一章
## 1.1 第一节
## 1.2 第二节

# 2. 第二章
## 2.1 第一节

#自动编号

某些编辑器和解析器支持自动编号：

/* CSS 自动编号 */
h1 { counter-reset: h2counter; }
h2 { counter-reset: h3counter; }
h2:before {
  content: counter(h2counter) ". ";
  counter-increment: h2counter;
}

#标题样式

#添加表情符号

# 📚 文档标题
## 🚀 快速开始
## 💡 使用技巧

#添加图标

## ⚙️ 配置
## 🔧 工具
## 📝 笔记

#标题与 SEO

在网页中，标题对 SEO 很重要：

#最佳实践

1. 每页只用一个 H1：作为主标题
2. 按层级使用：H1 → H2 → H3
3. 包含关键词：但要自然
4. 简洁明了：50-60 字符以内

# Python 入门教程：从零开始学习 Python

## 什么是 Python

## 为什么学习 Python

## 如何安装 Python

#标题在不同平台

#GitHub

GitHub 会自动为标题生成锚点链接：

## 安装步骤

可以通过 #安装步骤 链接到这个标题。

#博客平台

大多数博客平台支持标题语法，并自动生成目录。

#文档工具

VitePress、Docusaurus 等工具会自动生成侧边栏导航。

#标题快捷键

#VS Code

• Ctrl/Cmd + Shift + ]：增加标题级别
• Ctrl/Cmd + Shift + [：减少标题级别

#Typora

• Ctrl/Cmd + 1-6：直接设置标题级别
• Ctrl/Cmd + 0：设置为段落

#Obsidian

• Ctrl/Cmd + 1-6：设置标题级别

#实用技巧

#1. 快速生成目录

使用工具自动生成目录：

<!-- 自动生成的目录 -->
- [第一章](#第一章)
  - [第一节](#第一节)
  - [第二节](#第二节)
- [第二章](#第二章)

#2. 标题模板

创建常用的标题结构模板：

# 项目名称

## 简介

## 安装

## 使用方法

## API 文档

## 常见问题

## 贡献指南

## 许可证

#3. 使用标题大纲

在编辑器中使用大纲视图快速导航：

• VS Code：Ctrl/Cmd + Shift + O
• Typora：侧边栏大纲
• Obsidian：右侧大纲面板

#常见问题

#标题中的特殊字符

## 标题中的 `代码`
## 标题中的 **粗体**
## 标题中的 [链接](URL)

#标题过长

如果标题过长，考虑：

1. 简化标题文字
2. 使用副标题
3. 在正文中详细说明

## 安装

详细的安装步骤说明...

#标题重复

避免使用相同的标题文本，否则锚点链接可能冲突：

✅ 推荐
## Python 安装
## Node.js 安装

❌ 不推荐
## 安装
## 安装

#标题检查清单

• 使用了合适的标题级别
• 标题前后有空行
• # 后有空格
• 没有跳级使用标题
• 标题简洁明了
• 每页只有一个 H1
• 标题能反映内容

#小结

标题是 Markdown 文档的骨架，合理使用标题可以：

• 提高文档可读性
• 方便读者快速定位内容
• 自动生成目录和导航
• 改善 SEO 效果

下一步： 学习 Markdown 文本格式 的详细用法。