Sublime Text安装Markdown预览生成静态网页插件

P粉328763957

P粉328763957

2026-08-01

662人浏览

原创

sublime text预览markdown必须同时安装markdownediting和markdownpreview插件,缺一不可;仅装前者可高亮但无法预览,仅装后者则语法识别失败、命令不可见;安装后须重启、设语法为markdown gfm、配置parser为github并启用mathjax,否则样式、公式均不渲染。

sublime text安装markdown预览生成静态网页插件

装完 MarkdownPreview 插件后,预览默认就是生成静态 HTML 文件——它不依赖服务器,也不走网络,直接写入临时目录并用浏览器打开。所谓“静态网页”,正是它的默认行为,不是额外功能,也无需开启特殊开关。

必须同时装 MarkdownEditingMarkdownPreview

只装 MarkdownPreview,.md 文件在 Sublime 里仍是 Plain Text,右下角不显示 Markdown,Markdown Preview: Preview in Browser 命令根本不会出现;只装 MarkdownEditing,能高亮、能快捷插入标题,但点预览会报 command not found: markdown_preview

  • 安装顺序无所谓,但两个都得通过 Package Control 装(别搜 “Markdown Previewer” 或 “OmniMarkupPreviewer”,那些已停更或不兼容)
  • 装完必须重启 Sublime,否则插件不加载,命令面板搜不到相关命令
  • 打开 .md 文件后,务必点击右下角语言标识 → 选 MarkdownEditing → Markdown GFM,否则 GitHub 表格、任务列表、数学公式等特性不生效

parser 设成 github 才能渲染样式和公式

默认解析器是 markdown,它只转基础语法,不加载 GitHub CSS、不支持 MathJax。如果你预览出来是白底黑字、表格错位、公式显示为原始 LaTeX,说明 parser 没配对。

Sublime Text Build Linux版
Sublime Text Build Linux版

Sublime Text Linux x86-64 deb 安装包。官方也提供 rpm、tar.xz 和软件源安装方式。

下载
  • Preferences → Package Settings → Markdown Preview → Settings – User
  • 加这三行(缺一不可):
    "parser": "github",
    "enable_mathjax": true,
    "github_mode": true
  • 注意:gfm parser 不支持 MathJax,必须用 githubmarkdownenable_mathjax

快捷键、自动刷新、浏览器路径全得手动配

MarkdownPreview 默认不绑快捷键、不监听保存、不指定浏览器——你按 Ctrl+B 没反应,不是插件坏了,是它压根没接管这个键位。

  • 快捷键:进 Preferences → Key Bindings – User,加一行:
    {"keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "github"}}
  • 自动刷新:设 "enable_autoreload": true,但仅对已保存的本地文件有效;未保存的 untitled 标签页或远程路径不触发
  • 浏览器路径:Windows 上若报 Permission denied,改 "browser": "default";macOS 若 Safari 空白,临时切 "browser": "safari";Chrome 路径含空格时,用正斜杠写成 "browser": "C:/Program Files/Google/Chrome/Application/chrome.exe"

预览空白页?先看控制台报什么错误

空白页几乎从不因为插件本身损坏,而是环境或配置断链。打开 View → Show Console,再执行预览,看输出:

  • ImportError: No module named markdown → 运行 pip install markdown(用系统 Python,不是 Sublime 自带的那个)
  • UnicodeEncodeError: 'gbk' codec can't encode character → 文件路径含中文,要么改路径,要么在设置里加 "encoding": "utf-8"
  • 控制台没报错但页面空白 → 检查浏览器是否拦截了本地文件协议(file://)的样式加载,换 Chrome 并确保没开“阻止弹出窗口”

最常被忽略的一点:所有配置项都必须写在 Settings – User 里,而不是 Settings – Default;改错文件等于没改。另外,enable_autoreload 和 LiveReload 是两套机制,后者需额外装插件并手动启用,前者纯靠插件自身轮询,别混用。

相关文章

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

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

下载

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

相关专题

更多
li是什么元素
li是什么元素

li是HTML标记语言中的一个元素,用于创建列表。li代表列表项,它是ul或ol的子元素,li标签的作用是定义列表中的每个项目。本专题为大家li元素相关的各种文章、以及下载和课程。

2023.08.03

596

5

墨刀AI提示词教学
墨刀AI提示词教学

本合集由PHP中文网精心整理,为您提供全面的墨刀AI提示词教学。内容涵盖高质量原型撰写公式与实操窍门,助您轻松掌握AI设计工具。无论是零基础入门还是进阶技巧,都能让您快速上手,大幅提升产品设计与协作效率。

2026.08.04

8

21

墨刀AI完整入门
墨刀AI完整入门

PHP中文网为您倾力打造墨刀AI保姆级入门指南完整版!本合集从零基础讲起,涵盖AI生成原型、提示词优化、图片转原型及多轮对话等核心功能。无论您是新手还是进阶用户,都能轻松掌握产品设计全流程。快来PHP中文网,一键解锁高效设计技巧,让想法即刻成型!

2026.08.04

3

20

墨刀AI进阶技巧
墨刀AI进阶技巧

本合集由PHP中文网精心整理,为您提供墨刀AI核心进阶策略指南。内容涵盖高效提示词写作、原型智能生成与微调、结构化导图制作及行业分析报告输出等实战技巧。助您轻松掌握AI设计工具,大幅提升产品设计与团队协作效率。

2026.08.04

7

14

火山引擎实名认证失败怎么办
火山引擎实名认证失败怎么办

火山引擎实名认证失败可能与证件信息填写错误、姓名或企业信息不一致、证件照片不清晰、营业执照状态异常、手机号验证失败或审核资料不完整有关。本专题整理个人认证、企业认证、资料上传、审核退回、重新提交和认证不通过的常见处理方法。

2026.08.04

4

10

火山引擎域名备案流程详解
火山引擎域名备案流程详解

火山引擎域名备案适合需要在火山引擎云服务器、对象存储、CDN或网站服务上绑定域名的用户参考。本专题整理备案入口、账号实名认证、备案类型选择、主体信息填写、网站信息提交、资料上传、初审核验、管局审核和备案失败排查,帮助用户完成网站上线前的备案流程。

2026.08.04

0

10

火山引擎DNS解析配置步骤
火山引擎DNS解析配置步骤

使用火山引擎DNS解析网站域名时,需要确认域名已完成管理接入,并正确配置服务器IP、CNAME地址或验证记录。本专题整理域名添加、记录类型选择、TTL设置、解析状态检查、备案和访问测试等流程,适合新手搭建网站时参考。

2026.08.04

2

10

火山引擎对象存储使用教程
火山引擎对象存储使用教程

火山引擎对象存储适合用于网站图片、视频文件、备份数据、静态资源和应用附件管理。本专题整理TOS控制台入口、存储桶创建、地域选择、权限设置、文件上传、访问链接生成、CDN加速、费用查看和常见上传或访问失败问题,帮助用户快速掌握对象存储基础操作。

2026.08.04

1

10

火山引擎云服务器使用教程
火山引擎云服务器使用教程

火山引擎云服务器使用教程适合第一次购买、部署和管理云服务器的用户参考。本专题整理控制台入口、实例创建、地域和配置选择、系统镜像设置、安全组放行、远程连接、网站部署、续费计费和常见连接失败问题,帮助用户快速完成云服务器基础使用流程。

2026.08.04

5

10

热门下载

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

精品课程

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