常见问题

关于 MarkPDF 的常见疑问解答

这个工具支持哪些 Markdown 语法?

MarkPDF 支持 CommonMark 语法:标题、段落、强调、列表、链接、图片、代码块、引用和分隔线,以及 GitHub 风格的表格、删除线和自动链接。数学公式可以用 $ … $ 和 $$ … $$ 书写。

文字版和图片版 PDF 有什么区别?

有两种导出方式。“下载 PDF(文字版)”使用浏览器的打印引擎:文字可以选中和搜索,链接可点击,文件小,在打印窗口中选择“另存为 PDF”即可。“快速下载(图片版)”一键把页面保存为图片(A4 约 180 DPI),效果与预览完全一致,但文字不能选中,也无法被搜索或招聘系统识别。在微信、Facebook、Instagram 等 App 内置浏览器中可能无法打印,因此会优先提供图片版。

是否支持数学公式和代码高亮?

支持。代码块使用 highlight.js 高亮(190 多种语言),$ … $、$$ … $$、\( … \)、\[ … \] 中的公式使用 KaTeX 渲染。

文件大小有限制吗?

由于所有处理都在浏览器端完成,实际限制取决于你的设备性能。一般来说,处理几十 KB 的 Markdown 文件(约几万字)完全没有问题。对于超大文档,可能需要等待较长的渲染时间。

如何选择合适的 CJK 字体?

根据你的文档语言选择对应的字体:简体中文选择 Noto Sans SC 或思源黑体;繁体中文选择 Noto Sans TC;日文选择 Noto Sans JP;韩文选择 Noto Sans KR。如果文档包含多种语言,建议使用思源黑体,它对多语言的支持最为全面。

转换速度有多快?

转换速度取决于文档长度和复杂度。对于一篇 2000 字左右的普通文章,转换通常只需 2-3 秒。包含大量表格或代码块的长文档可能需要 5-10 秒。整个过程在你的浏览器中本地完成,不需要网络传输。

你们会保存我的文档内容吗?

不会。MarkPDF 的所有处理都在你的浏览器本地完成,你的文档内容永远不会发送到我们的服务器。我们非常重视用户隐私,这也是我们选择客户端渲染技术的重要原因之一。

是否支持批量转换?

目前版本一次转换一个文档,暂不支持批量转换。

能否自定义 PDF 样式和主题?

可以在设置面板中选择字体、字号、纸张(A4、Letter、A5)和页边距,设置会保存在本设备上。自定义 CSS 和页眉页脚暂不支持。

是否有 API 接口可以调用?

目前没有提供 API 接口。MarkPDF 是一个纯前端应用,所有处理都在浏览器中完成。如果你需要在自己的应用中集成 PDF 生成功能,可以参考我们使用的开源库(markdown-it + html2pdf.js)。

支持哪些浏览器?

MarkPDF 支持所有现代浏览器,包括 Chrome 80+、Firefox 75+、Safari 14+、Edge 80+。我们推荐使用最新版本的 Chrome 或 Edge 以获得最佳体验。不支持 Internet Explorer。

移动端可以使用吗?

可以!MarkPDF 采用响应式设计,在手机和平板上也能正常使用。不过由于屏幕尺寸限制,移动端会采用上下布局而非左右分栏。在移动端,你可以通过点击「预览」按钮来切换编辑和预览视图。

是否支持图片插入?

支持!你可以使用标准的 Markdown 图片语法插入在线图片。目前版本暂不支持本地图片上传,建议先将图片上传到图床服务(如 Imgur、sm.ms 等),然后使用图片链接插入。

可以导出其他格式吗?

目前主要支持 PDF 格式导出。HTML 导出功能正在开发中。其他格式如 Word (.docx) 的支持将在未来版本中考虑添加。

遇到问题去哪里找答案?

MarkPDF 不提供一对一支持。大部分问题都能在本 FAQ、使用教程和排障指南中找到答案,指南里详细介绍了字体、编码和排版问题的解决方法。