导出 HTML 与 PDF——Markor 把 Markdown 变成网页和可打印文档
Markor 的导出选项
Markor 不做云服务导出——所有导出都是 纯本地 完成的。支持两种格式：
| 格式 | 方法 | 包含什么 | 适合 |
|---|---|---|---|
| HTML | 把 Markdown 渲染结果 + 引用的图片一起保存为 .html | 完整 Markdown 内容（含 KaTeX、代码块、表格、图片），无依赖 | 分享给用浏览器的朋友，个人网站发布 |
| 走 Android 系统打印服务 + PDF 生成 | 完整内容的可打印版本，带分页和页码 | 打印、归档、分享给不熟悉 Markdown 的人 |
导出为 HTML
操作步骤
- 打开要导出的文件（Markdown / AsciiDoc / Org-Mode）
- 切到 预览模式（View Mode）
- 点顶部菜单 → Save as HTML（具体菜名可能因版本略有不同）
- 选择保存位置 → Markor 生成
.html文件
HTML 里有什么
Markor 生成的 HTML：
- 使用 flexmark-java 渲染结果（和你在手机 WebView 预览里看到的一模一样）
- 引用的本地图片会被自动内联（转成 base64 或复制到同目录）
- KaTeX 公式、代码块高亮、表格、列表、引用块都会被正确渲染
- 不依赖外部网络资源（所有 CSS 和 JS 都内联或本地引用）
HTML 导出的局限
- KaTeX 在 HTML 导出中 可能不完整（取决于 KaTeX 是怎么嵌入的）
- 代码块的语法高亮 CSS 可能和你之前用的 Markdown 渲染器略有差异
- 如果原始文档引用了 外部图片 URL（网络图片），导出的 HTML 里还是那个 URL——本地没有那张图片，打开 HTML 时需要联网
推荐的 HTML 用法
| 场景 | 操作 |
|---|---|
| 分享给朋友 | 生成 HTML → 用 Syncthing 同步 → 朋友在浏览器打开 |
| 个人小网站 | 把 HTML 文件 + 图片部署到 GitHub Pages / Cloudflare Pages |
| 备份归档 | 定期把 Markdown 文件导出一份 HTML，双保险 |
导出为 PDF
操作步骤
- 打开要导出的文件
- 切到预览模式
- 点顶部菜单 → Print / Save as PDF
- Android 系统打印对话框里选 保存为 PDF（或连接真实打印机）
- 选择保存位置 → Markor 走 Android 的打印管道生成 PDF
PDF 里有什么
PDF 导出完全走 Android 系统的 打印 → PDF 生成 管道，所以：
- Markdown 渲染结果（标题、列表、代码块、表格、图片）都正确
- 分页和页码由 Android 系统自动处理
- PDF 不支持 KaTeX 公式的正确渲染（需要额外的数学字体）
- PDF 不支持 代码块的彩色语法高亮（Android 打印服务通常不保留彩色高亮）
PDF 导出的替代方案
如果需要 高质量 PDF（保留 KaTeX 公式、彩色代码高亮、更好的排版），用 pandoc 在桌面端做：
pandoc input.md -o output.pdf --pdf-engine=xelatex -V mainfont="Noto Sans CJK SC"这是大多数技术文档场景下的推荐路线——手机上写 Markdown，桌面 pandoc 出 PDF。
导出 vs 同步 vs 分享
| 方式 | 适合场景 | 保留格式完整性 |
|---|---|---|
| HTML 导出 | 需要在任何浏览器里打开 | ✅ 高（但要注意外部图片 URL） |
| PDF 导出 | 打印、正式归档 | ⚠️ 中等（丢失部分高级格式） |
| 分享到其他 App | 快速转发给联系人 | ⚠️ 取决于目标 App 怎么处理 Markdown |
| Syncthing 同步 | 长期维护、桌面端继续编辑 | ✅ 最高（原始 Markdown 完全保留） |
导出后文件的存放
HTML / PDF 文件可以存放在任何位置——建议：
- 和原始 Markdown 文件放在 同一个目录（方便管理和同步）
- 或放在独立的
exports/目录下（大量导出时避免和源文件混在一起）
同步客户端会把导出的文件和源文件 一起同步。如果只是临时导出一份，导出后觉得没用了就删掉，保持工作区清爽。