支持

欢迎通过 support@lakesoft.jp 提出问题、报告错误或提交功能建议。

常见问题

按空格键仍然只显示纯文本

快速查看扩展必须先被启用，macOS 才会使用它们：

1. 将 qlmd 移动到应用程序文件夹，并打开一次
2. 打开系统设置 → 通用 → 登录项与扩展
3. 在扩展列表中找到快速查看，确认 qlmd 已打开
4. 关闭预览，再次按下空格键

如果仍然只显示纯文本，请在终端运行 qlmanage -r 以重新加载快速查看生成器，或退出登录后重新登录。

qlmd 可以预览哪些文件？

扩展名为 .md、.markdown、.mdown 和 .mkd 的文件。

我改了一个设置，但预览看起来没变

设置会在下一次预览时生效。请关闭快速查看窗口，再次按下空格键。macOS 还会按文件缓存预览——如果某个你已经看过的文档仍显示旧样式，请在终端运行 qlmanage -r cache。

我的代码块没有高亮

qlmd 内置了一组精选语言（Swift、JavaScript、TypeScript、Python、Bash、JSON、YAML、XML/HTML、CSS、Go、Rust、C、Java、Ruby、SQL、diff 以及 Markdown，外加常见的别名）。不在此列表中的语言会以纯文本显示，不会高亮。请告诉我们你需要哪种语言，我们会考虑加入。

Mermaid 图表显示为代码

请确认 qlmd 应用的 Extensions 标签页中 Mermaid 已打开。如果已经打开，图表的源码可能不是有效的 Mermaid 语法——在 GitHub 上渲染同一份文档也会出现同样的问题。

文档中的图片没有显示

以相对路径引用的图片会根据文档所在的文件夹来解析。如果文件被移动或重命名，qlmd 会显示替代文本而不是图片。远程图片（http:// / https://）不会被加载：预览功能在设计上就被阻止建立网络连接。

如何导出 PDF 或 HTML 文件？

在 qlmd 应用中打开文档——快速查看预览本身没有菜单栏——然后选择 File → Export as PDF… 或 Export as HTML…。PDF 是与文档等高的单个连续页面，而不是一叠按纸张大小分页的文件，其中的文字也保持可选中状态。HTML 文件自带样式并内嵌所用图片，因此可以单独在任何地方打开。

支持哪些 macOS 版本？

qlmd 需要macOS 15（Sequoia）或更高版本。你可以在Apple 菜单 → 关于本机中查看你的系统版本。

qlmd 会把我的文档发送到任何地方吗？

不会。一切渲染都在你的 Mac 上完成，预览功能无法建立网络连接。详情请参阅隐私政策。

仍未解决？

请发送邮件至 support@lakesoft.jp，并附上你的 macOS 版本、qlmd 版本（在应用的 About 标签页查看），以及（如果方便的话）出问题的 Markdown 文件。