Typora怎么插入目录?用[TOC]自动生成文章大纲

在撰写长篇文档或技术教程时，清晰的导航结构能极大提升阅读体验。Typora 提供了一套极简的目录生成机制，只需在文档中插入特定标记，即可根据标题层级自动生成可点击的大纲。这种做法无需手动维护链接，当章节调整时，目录也会随之自动更新。

Typora 中基于 [TOC] 生成的自动目录效果

实现这一功能的核心在于规范的 Markdown 标题语法与 [TOC] 标记的配合。只要文档中使用了标准的井号（#）标题，Typora 就能识别并构建层级关系。下面以一份包含多级标题的示例文档为例，逐步演示如何插入并优化目录。

1. 先用标题层级整理文章

目录的本质是标题的索引，因此第一步是确保正文使用了正确的 Markdown 标题格式。打开 Typora，新建一个 .md 文件。

在编辑区输入内容时，使用井号加空格来定义标题级别。例如，输入 ## 项目背景 作为二级标题，输入 ### 实施步骤 作为三级标题。一级标题通常用于文档总标题，建议每个文档只保留一个一级标题。

注意区分“标题”与“加粗文本”。仅将文字加粗或放大字号并不会被识别为目录项，必须使用 # 语法。保持层级连续，避免从二级直接跳到四级，这样生成的目录结构才会逻辑清晰。

2. 在文档开头输入[TOC]

确定好标题结构后，将光标移动到文档最上方，通常位于一级标题之下、正文开始之前。

单独起一行，准确输入 [TOC] 五个字符。注意方括号必须是英文半角符号，中间不要添加空格，也不要写成 [ toc ] 或其他变体。输入完成后按下回车键，确保该标记独占一行。

在文档开头单独一行输入英文半角的 [TOC]

此时在源码模式下，你只能看到 [TOC] 这行文字。Typora 采用所见即所得（WYSIWYG）模式，目录的实际渲染效果需要在预览状态或导出视图中才能完整呈现。

3. 查看目录是否按标题生成

观察编辑器界面，如果当前处于“源代码模式”，请点击工具栏的【源代码】按钮切换回“实时预览”或普通编辑视图。

正常情况下，[TOC] 所在的位置会立即渲染为一个列表，列出文档中所有的二级及以下标题。列表项会根据标题层级产生缩进，二级标题靠左，三级标题向右缩进，形成树状结构。

预览模式下，[TOC] 渲染为带缩进的层级列表

检查目录中的文字是否与正文标题完全一致。如果目录为空，请返回正文检查：是否误用了中文全角括号？是否将标题写成了加粗文本？或者 [TOC] 是否被意外包含在代码块中？

4. 通过调整标题修正目录结构

目录是动态生成的。尝试修改正文中的某个标题文字，例如将 ## 项目背景 改为 ## 背景介绍，观察目录中的对应项是否同步更新。

如果调整了标题层级，比如将某个三级标题升级为二级，目录中的缩进关系也会相应改变。若发现目录未即时刷新，可尝试点击文档其他区域，或暂时切换到源代码模式再切回，强制编辑器重新渲染。

保持标题层级的规范性不仅为了美观，更为了确保目录的逻辑连贯性。避免为了视觉大小而跳过层级，这会导致目录出现不自然的深层嵌套。

4. 通过调整标题修正目录结构

5. 目录不显示时按顺序排查

如果在预览中仍未看到目录，可以进行最小化测试。新建一个空白文档，仅输入以下内容：

# 测试文档

[TOC]

## 第一章

### 第一节

如果这个简单文档能正常显示目录，说明原文件可能存在语法冲突。常见原因包括：

• 代码块干扰：检查 [TOC] 是否被包裹在三个反引号 ``` 的代码块中。
• 注释隐藏：确认该行没有被 HTML 注释 包裹。
• 版本差异：极少数旧版本或特定主题可能对该标记支持不佳，建议更新至 Typora 最新稳定版。

6. 保存前确认目录和跳转效果

完成排版后，点击目录中的任意一项，测试是否能平滑滚动并定位到对应的正文标题。这是验证目录可用性的关键一步。

当需要导出为 PDF 或 HTML 时，先使用【文件】>【导出】>【PDF】进行预览。不同导出主题对目录的样式渲染可能有所不同，部分主题可能会隐藏目录或改变其字体大小。如果发现导出文件中目录缺失，需在导出设置中检查是否勾选了“包含目录”或类似选项（具体取决于所选主题的支持情况）。

最终保存 .md 源文件时，保留 [TOC] 标记即可。无需将其转换为静态文本，这样后续继续编辑文档时，目录仍能保持自动更新的能力。

6. 保存前确认目录和跳转效果