文档

常见问题

关于平台、更新、Markdown 支持、恢复机制与故障排除的常见解答，以及当前版本已知的限制。

Markion 是什么？

Markion 是一款使用 Rust 与 GPUI GPU 加速 UI 框架构建的原生桌面 Markdown 编辑器。它提供四种视图模式——编辑、可视化编辑、分栏与阅读——外加可折叠大纲、文件树工作区面板、查找替换、专注与打字机模式，以及多格式导出。

• 许可证： MIT
• 仓库： github.com/willmove/markion
• 问题反馈： GitHub Issues

支持哪些平台？

发布版本未进行平台代码签名，首次启动仍可能看到 Gatekeeper（macOS）或 SmartScreen（Windows）警告，手动放行即可运行。Windows x86_64 的应用内更新器会单独用 Minisign 密钥验证其 NSIS 负载，但这不会消除 SmartScreen 提示；macOS 和 Linux 的更新操作会在系统浏览器中打开发布下载。通过 .deb 安装的 Linux 用户会自动引入所需的运行时库（Wayland / X11 / Vulkan / fontconfig）。

支持哪些 Markdown 语法？

Markion 使用 pulldown-cmark（CommonMark + GFM），并启用了：

• CommonMark 基线
• GitHub Flavored Markdown：表格、删除线、任务列表、自动链接
• 脚注
• 数学公式（$行内$ 与 $$块级$$）
• ```mermaid Mermaid 图表（围栏代码块——流程图、时序图等）
• 智能标点（弯引号、破折号）
• 标题属性
• YAML 前言（--- 分隔，title / author / date 用于导出）
• 扩展行内语法（Markion 特有，叠加在 pulldown-cmark 文本段之上）：==高亮==、^上标^、~下标~、emoji 短代码（如 :smile:、:heart:）、裸自动链接

详见 Markdown 与渲染。脚注始终启用，没有单独的开关。

四种视图模式有什么区别？

用 Ctrl+Shift+V 在四种模式间循环（默认可视化编辑），或用 Ctrl+//Ctrl+E/Ctrl+P/Ctrl+R直达：编辑（仅源码）、可视化编辑（所见即所得优先、基于源码）、分栏（左源码右预览）、阅读（仅渲染预览，不可编辑）。切换模式会保留当前文档、光标/选区、撤销历史与每个标签页的滚动状态。详见 编辑模式。

数学公式如何排版？

屏幕渲染（分栏/阅读预览与可视化编辑）使用内嵌的 RaTeX 引擎（兼容 KaTeX、内嵌字体）把 $行内$ 与 $$块级$$ 公式排版为缓存的 SVG——无需联网，也无需安装外部 LaTeX。LaTeX 导出保留原生 $...$/$$...$$ 源码交给读者自己的工具链；内置 DOCX 导出会将公式降级为可读的 Unicode 纯文本近似显示。

自动保存与崩溃恢复如何工作？

Markion 默认在停止输入 5 秒后写入恢复快照，并将已命名文档静默保存回原文件。可在“偏好设置 → 常规”关闭静默保存或调整 1–300 秒延迟。关闭静默保存仍保留恢复保护；只有将 enabled = false 才会停用两者：

[auto_save]
enabled = true
silent_save = true
delay_secs = 5

对于从未保存到文件的文档，Markion 会向恢复目录写入恢复副本；如果 Markion 意外退出，下次启动会提供从该副本还原未保存工作的选项。存在未保存更改时，标题栏会在文件名旁显示 * 后缀。

大文档性能如何？

Markion 按文档版本缓存派生状态（预览块、大纲、统计信息、语法高亮）并通过 Arc 共享，因此在大文档中输入不会在每次击键时重新派生所有内容。syntect 语法库在启动时于主线程之外加载，首次渲染保持响应。带源码映射的可视化编辑在局部编辑后增量复用可独立解析的区域，当 Markdown 上下文或字节范围无法确定时回退为完整派生；分栏/阅读预览的派生保持防抖与缓存而非增量。Markion 仍使用 String 缓冲区而非 rope，部分语义读取也会有意执行完整解析。

故障排除

• macOS 提示“无法打开，因为来自身份不明的开发者”。 这是 Gatekeeper。右键应用并选择“打开”，或在“系统设置 → 隐私与安全性”中点击“仍要打开”。发布版本未签名。
• Windows SmartScreen 在运行安装程序前发出警告。 点击“更多信息 → 仍要运行”。发布版本未签名。
• 如何选择 PDF 导出后端？ 在“偏好设置 → 导出”中选择内置引擎或 Pandoc。默认内置引擎支持中英文排版、图片、表格、代码和矢量公式，无需安装外部工具。选择 Pandoc 时需要对应工具链，不可用或转换失败时会回退到内置引擎。状态栏会说明实际后端。
• 自定义主题没有出现在偏好设置中。 确认 .toml 文件位于主题目录（见 主题、语言与偏好设置中的数据目录表），其 name 字段已设置且非空，且没有同名的内置主题（内置主题优先）。
• 日志在哪里？ 见 主题、语言与偏好设置中数据目录表的日志目录列。启动前设置 RUST_LOG=debug 可提高日志详细程度。

已知限制

• 可视化编辑以所见即所得为默认呈现契约，同时保留标准 Markdown；暂无字节精确渲染证明的结构会以源码作为过渡编辑通道（登记在 WYSIWYG 覆盖路线图中），而不会猜测富文本树变更；仅当可证明存在不重叠的源码边界时才提供块级重排。
• 屏幕渲染（分栏/阅读预览与可视化编辑）使用内嵌的 RaTeX 引擎排版数学公式；LaTeX 导出保留原生 $...$/$$...$$ 源码交给读者自己的工具链处理，内置 DOCX 导出后备通道仍会将公式降级为可读的纯文本近似显示，而非嵌入排版好的字形。
• 可视化表格单元格支持直接纯文本编辑，但尚未提供单元格内的富行内格式控件。引用式/多行图片、畸形表格和正文中的 HTML 实体仍是 WYSIWYG 覆盖路线图上的已知缺口，暂时保留源码驱动编辑路径。
• 一键更新在完成 Minisign 验证后会安装 Windows NSIS 版本；macOS 包替换与 Linux .deb/AppImage 自替换仍是后续工作，且更新身份验证并非 Windows Authenticode 或 Apple 公证。
• 尚未提供完整的自定义主题安装界面，主题文件仍需手动放入主题目录。
• 图片导出是基于文档排版的静态快照，超大文档尚未在所有派生子系统中使用 rope 或完全增量解析。

报告问题

请到 GitHub Issues 提交问题。附上 Markion 版本号（启动日志第一行可见）与平台信息会更有帮助。