在markdown中生成可点击目录需依平台而定：typora用[toc]并空行；vscode需安装插件后执行命令；静态站点则手动编写带锚点链接的列表，并确保标题语法规范。
要在 Markdown 文档中快速生成可点击跳转的目录，必须依赖编辑器或解析器对标题层级的识别能力，不是所有平台都支持自动插入，得先确认你用的是 Typora、VSCode 还是静态博客生成器。
Typora 中用 [TOC] 一行搞定目录
打开 Typora，新建或打开一个 .md 文件。
在文档最开头或任意你想放目录的位置，单独写一行：[TOC]。
保存后，Typora 会立即把这一行替换成带链接的层级列表，所有以 # 至 ###### 开头的标题都会被收录。注意：【必须保留前后空行，否则可能被当成普通文本渲染】。
修改标题文字后，目录不会自动刷新，需手动删掉旧 [TOC] 行，再重新输入一次并回车。
VSCode 中靠插件生成结构化目录
方法一：安装 Markdown All in One 插件 → 按 Ctrl+Shift+P → 输入“Create Table of Contents” → 回车执行。
方法二：光标定位到目标位置 → 右键 → 选择“Create Table of Contents”。
生成的目录默认使用无序列表格式，每项都是形如 - [标题](#标题锚点) 的链接。锚点由标题内容转换而来：中文变小写拼音、空格和标点被移除，例如 ## 安装步骤 对应锚点 #安装步骤。
这一步操作起来很简单，直接把文件拖进去就行。
GitHub / Jekyll / Hugo 等静态站点手动配目录
第一步：确保文档中所有标题都用标准语法书写，比如 # 一级标题、## 二级标题，且井号后必须空一格。
第二步：在想插入目录的位置，手动写一个带锚点链接的列表：
## 目录
- [简介](#简介)
- [安装](#安装)
- [配置](#配置)
第三步：为每个对应标题添加 id 属性（部分解析器如 kramdown 支持），或依赖解析器自动生成锚点——GitHub Flavored Markdown 默认开启此功能，无需额外操作。
第四步：检查预览效果，点击目录项是否能准确跳转到对应标题位置。如果跳转失败，大概率是标题含特殊符号未被正确编码，可改用纯英文标题临时验证。
