Sublime怎么搭建博客写作流程_Sublime如何用Markdown写博客【详解】

夏杰吖_3557

夏杰吖_3557

2026-03-30

291人浏览

原创

sublime写博客应精简高效:仅用markdownediting插件+pandoc命令行导出,禁用冗余插件;图片用相对路径存assets/目录且与md同级;导出html需加--standalone和--metadata确保utf-8编码;发布交由hexo/jekyll独立构建,截图用系统快捷键+paste_image自动存图。

sublime怎么搭建博客写作流程_sublime如何用markdown写博客【详解】

用 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 冲突
  • 所有图片路径统一用相对路径,比如 ![](assets/logo.png),这样 pandoc 导出 HTML 或 PDF 时才不会丢图

导出 HTML 时字体/样式总乱码?检查编码和 meta 标签

Sublime 默认保存为 UTF-8,但导出 HTML 后浏览器显示中文成方块,大概率是没显式声明字符集,或 CSS 引入方式不对。

Transfusion AI
Transfusion AI

一款面向室内设计场景的AI设计工具,帮助设计师围绕空间方案进行效果创作与视觉方案探索。

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

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

sublime

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

1975

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

2722

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

936

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

3059

7

while的用法
while的用法

while的用法是“while 条件: 代码块”,条件是一个表达式,当条件为真时,执行代码块,然后再次判断条件是否为真,如果为真则继续执行代码块,直到条件为假为止。本专题为大家提供while相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.25

334

5

登录token无效
登录token无效

登录token无效解决方法:1、检查token的有效期限,如果token已经过期,需要重新获取一个新的token;2、检查token的签名,如果签名不正确,需要重新获取一个新的token;3、检查密钥的正确性,如果密钥不正确,需要重新获取一个新的token;4、使用HTTPS协议传输token,建议使用HTTPS协议进行传输 ;5、使用双因素认证,双因素认证可以提高账户的安全性。

2023.09.14

12186

6

登录token无效怎么办
登录token无效怎么办

登录token无效的解决办法有检查Token是否过期、检查Token是否正确、检查Token是否被篡改、检查Token是否与用户匹配、清除缓存或Cookie、检查网络连接和服务器状态、重新登录或请求新的Token、联系技术支持或开发人员等。本专题为大家提供token相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.14

1485

5

token怎么获取
token怎么获取

获取token值的方法:1、小程序调用“wx.login()”获取 临时登录凭证code,并回传到开发者服务器;2、开发者服务器以code换取,用户唯一标识openid和会话密钥“session_key”。想了解更详细的内容,可以阅读本专题下面的文章。

2023.12.21

3257

3

token什么意思
token什么意思

token是一种用于表示用户权限、记录交易信息、支付虚拟货币的数字货币。可以用来在特定的网络上进行交易,用来购买或出售特定的虚拟货币,也可以用来支付特定的服务费用。想了解更多token什么意思的相关内容可以访问本专题下面的文章。

2024.03.01

5421

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程