装完 markdownpreview 插件后必须重启 sublime text，否则命令未注册；文件须保存为 .md/.markdown 后缀、语法模式设为 markdown、路径避免中文和空格，解析器需配置 gfm 扩展或改用 mistune 才支持表格等特性。

装完 MarkdownPreview 插件后，不重启 Sublime、不保存为 .md 后缀、不切到 Markdown 语法模式，预览命令就根本不会出现——这不是 bug，是设计逻辑。

为什么 Ctrl+Shift+P 里搜不到 Markdown Preview？

插件安装后必须重启 Sublime Text，否则命令未注册进命令面板。常见误操作是装完立刻试，结果搜不到任何 MarkdownPreview 相关命令。

• 确认右下角状态栏显示的是 Markdown，不是 Plain Text；点它 → Open all with current extension as… → Markdown
• 文件必须已保存，且后缀为 .md 或 .markdown；untitled 标签页不触发预览
• 检查是否误装了 MarkdownEditing（只管高亮）或 OmniMarkupPreviewer（配置逻辑完全不同），它们和 MarkdownPreview 不兼容
• 如果重启后仍不可见，在控制台（Ctrl+`）输入 sublime.list_commands()，搜索 markdown_preview 是否在返回列表中

预览打开空白页或报 404 怎么办？

空白页 ≠ 插件坏了，大概率是解析中断或资源加载失败。最常被忽略的是编码和路径问题。

MusicAI

一款AI音频处理工具，主要用于AI音乐生成工具，适合需要提升相关任务效率的用户。

下载

• 右下角点击编码名（如 UTF-8 with BOM），强制设为 UTF-8；中文乱码会导致 html.parser 解析失败，页面直接空
• Windows 用户避免中文路径或空格路径，比如 C:\我的文档\test.md 很可能失败；改用 C:\md\test.md
• 浏览器打不开？检查设置里 "browser" 字段是否写死路径；默认值为空时依赖系统 PATH，Chrome 若没加进环境变量就会静默失败
• 预览 HTML 中 CSS/JS 加载不了？别双击临时 HTML 文件——必须通过插件命令（Preview in Browser）打开，它走的是 Sublime 的本地服务代理

表格不渲染、代码块没高亮、删除线失效？

不是 CSS 没生效，是解析器压根没生成对应 HTML 结构。默认 "parser": "markdown" 只支持基础语法。

• 启用 GFM 特性：把设置里的 "parser" 改成 "github"（需联网 + GitHub token）或更轻量的 "mistune"（离线可用，支持表格、任务列表）
• 若坚持用 markdown 解析器，必须显式开启扩展："markdown_extensions": ["tables", "fenced_code", "codehilite", "toc"]
• codehilite 依赖 Pygments，而 Sublime 自带 Python 通常没装它；此时换解析器比硬配 codehilite 更可靠
• 数学公式默认关闭，要启用需加 "enable_math": true，并确保 MathJax CDN 可访问（离线场景建议用 KaTeX 配置）

想“实时刷新”但改完还得手动按快捷键？

MarkdownPreview 本身没有实时机制，所谓“自动刷新”是三端协同结果：Sublime 触发生成、浏览器监听变更、LiveReload 注入脚本——缺一不可。

• 先在设置里开 "enable_autoreload": true
• 浏览器装 LiveReload 扩展（Chrome/Firefox 均有），并点击图标启用监听
• 确保预览 HTML 页面里注入了 LiveReload 脚本；插件默认会加，但如果用了自定义 css 或 template，可能被覆盖
• 快捷键 Ctrl+Alt+M 默认只在 text.html.markdown 作用域生效；如果语法没识别对，快捷键完全不响应

真正容易被忽略的是作用域和路径约束：它不处理未保存文件、不兼容中文路径、不接管双击 HTML 的行为——这些不是缺陷，而是它作为“轻量渲染工具”的边界。