必须同时安装markdownediting和markdownlivepreview，前者提供语法高亮与编辑支持，后者实现所见即所得预览；中文乱码需converttoutf8转码+chineselocalization汉化；导出pdf/html依赖markdownpreview并配置本地css及系统工具。
MarkdownEditing 必装，但得配对 MarkdownLivePreview
写文档不是写代码，核心诉求是所见即所得 + 语法高亮 + 导出可控。只装 MarkdownEditing 会卡在“写了半天不知道渲染效果”，只装 MarkdownLivePreview 又缺基础语法支持（比如标题缩进、列表嵌套高亮）。两者必须一起用。
常见错误现象：预览窗口空白、点击刷新没反应、中文标题乱码、表格不渲染——基本都是没配对或路径识别失败。
-
MarkdownEditing负责语法识别和编辑体验：右下角状态栏显示 “Markdown” 才算激活；若显示 “Plain Text”，右键 → Set Syntax → Markdown 手动切过去 -
MarkdownLivePreview默认监听.md后缀，但不会自动打开预览窗；按Ctrl+Shift+P输入Markdown Live Preview: Toggle Preview才能唤出 - 预览页默认用内置 WebView，不支持 Mermaid 或数学公式；如需渲染，得额外装
MarkdownPreview（它用本地 Python 启服务，兼容性更好） - 中文路径或含空格的文件名会导致预览加载失败，建议项目根目录用英文命名，且通过 Project → Add Folder to Project 显式设置
中文文档别跳过 ConvertToUTF8 和 ChineseLocalization
Sublime Text 原生对 GBK/GB2312 编码的中文文件支持极差，直接打开就是乱码，保存后更可能损坏原有内容。这不是字体问题，是编码层解析失败。
常见错误现象：“文件内容全变成方块”、“保存后中文变问号”、“复制粘贴中文丢失”——这些都不是配置错，是根本没正确解码。
-
ConvertToUTF8是实时转码器：打开非 UTF-8 文件时自动尝试 GBK 解码，编辑后存为 UTF-8；但它不改原文件编码，只是“翻译”给你看 -
ChineseLocalization解决界面汉化，但注意：它不解决文档乱码，只让菜单、弹窗、提示语变成中文 - 两者安装顺序无所谓，但必须都启用；若仍乱码，检查右下角编码标识是否显示
UTF-8，不是就点它 → Reopen with Encoding → GBK - Git 仓库里已有 GBK 文件，
ConvertToUTF8会自动处理；但 CI 流程若强制 UTF-8 校验，建议批量转码后再提交
导出 PDF / HTML 需要 MarkdownPreview + 自定义 CSS
MarkdownLivePreview 只预览，不导出；MarkdownEditing 本身不带导出功能。真要生成交付物，得靠 MarkdownPreview —— 它能渲染 Mermaid、LaTeX 公式、自定义样式，且输出干净 HTML/PDF。
常见错误现象：“导出 PDF 字体糊成一片”、“代码块背景色丢失”、“标题层级错乱”——本质是 CSS 没接管渲染链。
- 装完
MarkdownPreview后，按Ctrl+Shift+P输入Markdown Preview: Preview in Browser或Markdown Preview: Export HTML - PDF 导出依赖系统级工具：Windows 需装
wkhtmltopdf并配置路径；macOS 推荐用weasyprint（pip install weasyprint） - 默认 CSS 简陋，要改样式必须编辑
Preferences → Package Settings → Markdown Preview → Settings – User，加"css": ["Packages/User/markdown.css"] - 别把 GitHub 风格 CSS 直接粘贴进去——它依赖网络字体，离线环境会白屏；本地 CSS 里用系统字体栈，例如
font-family: -apple-system, "Segoe UI", "Noto Sans CJK SC", sans-serif;
写长文档时容易忽略的三个硬伤
文档越长，越暴露 Sublime 的底层限制：没有大纲视图、不支持跨文件引用跳转、无法管理多级 TOC。插件能缓解，但不能根治。
- 大纲靠
CTags或Table of Contents插件生成，但它们只解析##级标题，对###或自定义锚点无效；手动维护 TOC 成本远高于收益 -
AutoFileName在 Markdown 里对图片路径补全有效，但对[链接文字](./path/to/file.md)中的 .md 文件不识别——得靠MarkdownHelper补这个缺口 - 搜索跨文件很弱：
Ctrl+Shift+F能搜整个项目，但不支持正则高亮上下文，也不标记匹配行在哪个文档里；实际写作中，常要反复切窗口确认上下文
真正写长文档，Sublime 是高效草稿箱，不是终稿工厂。定稿前导出 HTML，再用 Typora 或 Obsidian 做最终排版和交叉引用——这点别硬扛。
