Sublime Markdown Preview (stmpp)

面向 Sublime Text 4 的轻量级 Markdown 实时分栏预览插件。

内部 Package ID: SublimeMarkdownPreview

---

核心特性

• 纯原生内嵌：基于 Sublime Text 4 原生 sublime.HtmlSheet (minihtml)，无需开启外部浏览器。
• 极低资源开销：无 Electron、无 Node.js、无常驻独立后台服务，空闲内存占用小于 20MB。
• 50/50 左右分栏：一键开启侧边预览，关闭预览时自动恢复原有单栏/多栏布局。
• GFM 完整支持：
  • 语法着色代码块（Python、JS/TS、Go、Rust、C/C++、Bash、SQL、JSON 等）
  • 表格（支持左、中、右列对齐）
  • 任务列表（Task List [x] / [ ]）
  • 引用块、删除线、行内代码
• 本地图片与路径解析：兼容 Windows 反斜杠、盘符及相对路径（./img.png、../assets/）。
• 防抖实时刷新：输入默认 200ms 防抖，100KB 文件渲染速度在 50~80ms，杜绝卡顿。
• 视口比例同步滚动：依据编辑器当前视口滚动与光标位置，实时计算并对齐预览窗垂直像素坐标。
• 主题智能自适应：自动跟随 Sublime Text 主题明暗模式，亦可手动指定 Light / Dark。
• 目录导航与 HTML 导出：支持 Quick Panel 模糊搜索跳转章节，支持一键将 Markdown 导出为独立 HTML 文件。

---

快捷键

操作	Windows / Linux	macOS
开关预览	Ctrl + Shift + M	Super + Shift + M
强制刷新	Ctrl + Shift + Alt + M	Super + Shift + Alt + M

---

命令面板

按 Ctrl+Shift+P (或 macOS Cmd+Shift+P) 输入：

• Markdown Preview: Toggle Preview
• Markdown Preview: Open Preview to Side
• Markdown Preview: Open Preview
• Markdown Preview: Refresh
• Markdown Preview: Close Preview
• Markdown Preview: Open TOC
• Markdown Preview: Export HTML

---

配置说明

通过 Preferences -> Package Settings -> Sublime Markdown Preview -> Settings 打开配置：

{
    "preview_mode": "side",
    "split_ratio": 0.5,

    "auto_refresh": true,
    "refresh_delay": 200,

    "sync_scroll": true,
    "theme": "auto",

    "allow_html": true,
    "allow_remote_resources": false,

    "code_line_numbers": false,
    "copy_button": true,
    "toc": true,
    "toc_position": "right",
    "table_mode": "auto",

    "custom_css": "",
    "custom_css_file": ""
}

---

目录架构

stmpp/
  ├── plugin.py                         # 插件主入口与异步事件监听
  ├── commands/                         # 命令集实现 (Open, Close, Refresh, Toggle, TOC, Export)
  ├── renderer/                         # 纯 Python GFM 解析、代码高亮、路径解析与安全过滤
  ├── preview/                          # HtmlSheet 视图管理、双栏布局与视口比例同步
  ├── assets/                           # 基础与主题样式表 (preview.css, theme_light.css, theme_dark.css)
  ├── messages/                         # Package Control 安装与版本发布说明
  ├── tests/                            # 单元测试与基准性能套件
  ├── SublimeMarkdownPreview.sublime-settings # 核心配置文件
  ├── Default.sublime-commands          # 命令面板映射
  ├── Default (Windows).sublime-keymap  # Windows 快捷键映射
  ├── Default (OSX).sublime-keymap      # macOS 快捷键映射
  ├── Default (Linux).sublime-keymap    # Linux 快捷键映射
  ├── messages.json                     # Package Control 版本发布映射
  └── Main.sublime-menu                 # 菜单栏注册项

---

维护与支持

• 项目维护者：尹鸿文 (Taylor)
• 开源社区：
  • GitCode: https://gitcode.com/nexble/stmpp
  • GitLink: https://www.gitlink.org.cn/ai-famer/stmpp
• 联络邮箱：nexble@qq.com
• 议题反馈：优先通过 GitCode 或 GitLink Issues 提交工单