垦荒学园

简体中文

English

简体中文

English

切换主题

Markdown 标题 ​

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

基本语法 ​

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

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

标题级别 ​

一级标题 (H1) ​

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

markdown
# 文档标题

二级标题 (H2) ​

二级标题用于主要章节：

markdown
## 主要章节

三级标题 (H3) ​

三级标题用于子章节：

markdown
### 子章节

四级到六级标题 ​

用于更细分的内容层次：

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

替代语法 ​

Setext 风格标题 ​

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

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

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

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

标题最佳实践 ​

1. 使用空格 ​

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

markdown
✅ 推荐
# 标题

❌ 不推荐
#标题

2. 标题前后空行 ​

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

markdown
这是一段文字。

## 标题

这是另一段文字。

3. 保持层级结构 ​

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

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

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

4. 避免使用过多层级 ​

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

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

5. 标题要简洁明了 ​

markdown
✅ 推荐
## 安装步骤

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

标题 ID ​

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

markdown
## 我的标题

生成的 HTML：

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

自定义标题 ID ​

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

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

标题链接 ​

创建目录 ​

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

markdown
## 目录

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

## 第一章

内容...

## 第二章

内容...

## 第三章

内容...

链接到标题 ​

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

## 安装步骤

详细步骤...

标题编号 ​

手动编号 ​

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

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

自动编号 ​

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

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

标题样式 ​

添加表情符号 ​

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

添加图标 ​

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

标题与 SEO ​

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

最佳实践 ​

  1. 每页只用一个 H1：作为主标题
  2. 按层级使用：H1 → H2 → H3
  3. 包含关键词：但要自然
  4. 简洁明了：50-60 字符以内
markdown
# Python 入门教程：从零开始学习 Python

## 什么是 Python

## 为什么学习 Python

## 如何安装 Python

标题在不同平台 ​

GitHub ​

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

markdown
## 安装步骤

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

博客平台 ​

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

文档工具 ​

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

标题快捷键 ​

VS Code ​

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

Typora ​

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

Obsidian ​

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

实用技巧 ​

1. 快速生成目录 ​

使用工具自动生成目录：

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

2. 标题模板 ​

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

markdown
# 项目名称

## 简介

## 安装

## 使用方法

## API 文档

## 常见问题

## 贡献指南

## 许可证

3. 使用标题大纲 ​

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

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

常见问题 ​

标题中的特殊字符 ​

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

标题过长 ​

如果标题过长，考虑：

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

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

标题重复 ​

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

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

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

标题检查清单 ​

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

小结 ​

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

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

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