Sublime写博客应精简高效：仅用MarkdownEditing插件+Pandoc命令行导出，禁用冗余插件；图片用相对路径存assets/目录且与md同级；导出HTML需加--standalone和--metadata确保UTF-8编码；发布交由Hexo/Jekyll独立构建，截图用系统快捷键+paste_image自动存图。
用 Sublime 写博客，别装插件堆砌功能
Sublime 本身不是写作工具，硬塞一堆 Markdown 预览、图床上传、TOC 生成插件，反而让保存变慢、预览卡顿、Ctrl+S 时突然弹个错误。真正顺手的流程，是「写得快 + 导出稳」，不是「看起来全」。
核心就两条：用 MarkdownEditing 做语法和快捷键支撑，用 pandoc 命令行做最终导出。其他都算锦上添花，先别碰。
-
MarkdownEditing提供真实可用的Ctrl+Shift+P → Markdown: Preview in Browser，不依赖 Node 或 Python 环境，预览快且不崩 - 别用
Markdown Preview插件——它默认调用本地 Python 的markdown包，Windows 上常报ImportError: No module named markdown，Mac 上又容易和系统自带 Python 冲突 - 所有图片路径统一用相对路径，比如
，这样pandoc导出 HTML 或 PDF 时才不会丢图
导出 HTML 时字体/样式总乱码？检查编码和 meta 标签
Sublime 默认保存为 UTF-8，但导出 HTML 后浏览器显示中文成方块，大概率是没显式声明字符集，或 CSS 引入方式不对。
- 导出命令里必须加
--standalone和--metadata title="我的博客"，否则 pandoc 不会自动加<meta charset="UTF-8"> - 别在 Markdown 文件顶部写
<meta>标签——Sublime 不解析，pandoc 也不认，纯属干扰 - 自定义 CSS 要用
--css=style.css参数传入，不是靠link标签写在文档里；CSS 文件本身也必须存为 UTF-8 编码（无 BOM） - 如果用
pandoc -s -o output.html input.md导出后仍有乱码，试试加--ascii强制 ASCII 输出，再手动替换引号、破折号等 Unicode 符号
想一键发布到 Hexo/Jekyll？别在 Sublime 里做构建
有人装 SublimeOnSaveBuild，一保存就自动 hexo generate，结果改个标题就触发全站重建，本地预览延迟 3 秒以上，还经常因路径权限失败卡死。
- Hexo/Jekyll 的构建逻辑不在编辑器里，Sublime 只负责产出干净的
.md文件，扔进source/_posts/就完事 - 真要自动化，用 shell 脚本监听文件变化，比如
inotifywait -m source/_posts/ -e moved_to | while read path action file; do hexo clean && hexo g; done，比插件稳定得多 - 如果非要在 Sublime 里触发，只用
Build System配一个最简命令："cmd": ["sh", "-c", "cp '$file' ~/blog/source/_posts/"]，复制完就停，不跑构建
图片粘贴太麻烦？用系统级截图 + 快捷键替代插件
所谓「截图自动上传图床」在 Sublime 里基本不可靠：插件要配 token、要联网、要处理返回 JSON，一次失败就卡住光标。实际写博客，90% 图片来自本地截图或设计稿。
- Windows 用
Win+Shift+S，macOS 用Cmd+Shift+4，截图后直接Ctrl+V粘贴进 Sublime ——MarkdownEditing默认开启paste_image，会自动存为assets/xxx.png并插入链接 - 确认
Preferences → Package Settings → MarkdownEditing → Settings里有"paste_image_dir": "assets"，且该目录存在，否则粘贴失败不报错，只静默忽略 - 别用「自动重命名」类功能——比如把
Screenshot 2024-05-12 at 10.22.33.png改成fig-01.png，后期维护时根本不知道图对应哪段文字
复杂点在于：pandoc 导出时对相对路径非常敏感，assets/ 目录必须和 Markdown 文件同级，且不能跨盘符（比如 Sublime 打开的是 D:\blog\post.md，但 assets 在 C:\temp\assets，导出必丢图）。这个细节，八成人在调试半小时后才意识到。
