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,导出必丢图)。这个细节,八成人在调试半小时后才意识到。











