Sublime Text安装Markdown目录生成-sublime-PHP中文网

markdown preview 需配置 "parser": "github" 并启用 gfm 语法，[toc] 才能渲染为可点击目录；否则仅显示原文本，常见原因包括解析器不匹配、语法未设为 markdown gfm、网络限制或编码问题。

sublime text安装markdown目录生成

Sublime Text 默认不会自动生成目录（Table of Contents），MarkdownPreview 插件也不内置自动解析标题生成目录的功能。它只响应你手动写的 [TOC] 占位符——但前提是插件配置正确、语法识别到位，否则这个标记会被原样输出，不渲染成目录。

[TOC] 必须独占一行，前后无空格或其它字符，例如：[TOC] ✔️， [TOC] ❌
仅当使用 parser 为 github 或启用了 gfm 模式时，[TOC] 才会被识别（GitHub Flavored Markdown 原生支持该语法）
如果用的是 parser: "markdown"（默认 CommonMark 解析器），[TOC] 完全无效，预览里就显示原文本
确保当前文件已设为 Markdown GFM 语法（右下角点击 → MarkdownEditing → Set Syntax: Markdown GFM），否则插件可能不触发 GFM 特性

关键不是装新插件，而是确认 MarkdownPreview 的配置启用 GFM 支持，并绑定到正确的解析器。

Xlsx To Markdown

文档转 Markdown 转换器 - 将 DOCX、PPTX、Excel 文件转换为 Markdown。用于从 Word 文档、PowerPoint 演示文稿或 E... 提取内容。

下载

添加或修改以下配置项：

{
  "parser": "github",
  "enabled_extensions": ["toc"]
}

"parser": "github" 表示走 GitHub API 解析（需联网），它才认 [TOC]；"enabled_extensions" 是部分本地解析器需要的显式开关，但对 github parser 实际无效，加了也无害
保存后，重新保存一次 .md 文件（或按 Ctrl+Shift+P → Markdown Preview: Preview in Browser），[TOC] 应变成带锚点链接的层级目录
注意：GitHub API 有调用频率限制（约每天 60 次），若频繁刷新失败，可临时切回 parser: "markdown" 并改用第三方 TOC 生成工具

常见原因不是插件没装，而是环境链断在某个环节。

Package Control 未真正生效：按 Ctrl+Shift+P 输入 Package Control:，若命令灰色或报错 Unable to download package list，说明网络无法访问 GitHub raw 链接（国内常见），需换源或手动安装
只装了 MarkdownPreview 没装 MarkdownEditing：.md 文件仍被识别为 Plain Text，右下角不显示 Markdown GFM，[TOC] 根本不进入解析流程
浏览器缓存旧 HTML：预览页面没更新，强制刷新（Ctrl+F5）或关掉标签页重开
文件编码不是 UTF-8：含中文标题时，若保存为 GBK，GitHub API 可能解析失败，导致目录生成中断

如果网络不稳定或要离线用，[TOC] 就不可靠。这时可以手动或半自动补位：

用 Ctrl+Shift+P → 输入 MarkdownEditing: Insert TOC（该命令来自 MarkdownEditing 插件），它会扫描当前文档所有 # 级标题，生成纯 Markdown 格式的链接目录（无自动更新，但完全离线）
配合 SideBarEnhancements 插件，在侧边栏右键 .md 文件 → Open Containing Folder，用命令行跑 pandoc -s input.md --toc -o output.html 生成带目录的 HTML（需提前装 Pandoc）
别指望“一键全自动实时目录”——Sublime 生态里没有真正意义的后台监听+动态重绘目录的插件，所有所谓“自动”，本质都是保存/预览触发的一次性生成

实际写的时候，[TOC] 能用就用，不能用就切到 MarkdownEditing: Insert TOC 手动补。复杂文档建议导出前用 Pandoc 统一处理，别卡在 Sublime 里硬刚。