常见问题
关于 MarkPDF 的常见疑问解答
这个工具支持哪些 Markdown 语法?
MarkPDF 支持标准 CommonMark 规范的所有语法,包括标题、段落、强调、列表、链接、图片、代码块、表格、引用等。此外,我们还支持部分 GFM(GitHub Flavored Markdown)扩展语法,如任务列表和自动链接。
生成的 PDF 质量如何?分辨率是多少?
我们使用高质量渲染引擎生成 PDF,默认输出分辨率为 150 DPI,足以满足打印需求。生成的 PDF 文件清晰锐利,无论是在屏幕上查看还是打印出来,都能保持良好的显示效果。
是否支持数学公式和代码高亮?
代码高亮是完全支持的,我们使用 highlight.js 为 100+ 种编程语言提供语法高亮。数学公式支持正在开发中,未来版本将集成 KaTeX 或 MathJax 来渲染 LaTeX 数学表达式。
文件大小有限制吗?
由于所有处理都在浏览器端完成,实际限制取决于你的设备性能。一般来说,处理几十 KB 的 Markdown 文件(约几万字)完全没有问题。对于超大文档,可能需要等待较长的渲染时间。
如何选择合适的 CJK 字体?
根据你的文档语言选择对应的字体:简体中文选择 Noto Sans SC 或思源黑体;繁体中文选择 Noto Sans TC;日文选择 Noto Sans JP;韩文选择 Noto Sans KR。如果文档包含多种语言,建议使用思源黑体,它对多语言的支持最为全面。
转换速度有多快?
转换速度取决于文档长度和复杂度。对于一篇 2000 字左右的普通文章,转换通常只需 2-3 秒。包含大量表格或代码块的长文档可能需要 5-10 秒。整个过程在你的浏览器中本地完成,不需要网络传输。
你们会保存我的文档内容吗?
不会。MarkPDF 的所有处理都在你的浏览器本地完成,你的文档内容永远不会发送到我们的服务器。我们非常重视用户隐私,这也是我们选择客户端渲染技术的重要原因之一。
是否支持批量转换?
目前版本支持单个文档转换。批量转换功能正在规划中,将在未来版本中推出。如果你有批量转换需求,可以通过「关于我们」页面联系我们,我们很乐意听取你的建议。
能否自定义 PDF 样式和主题?
可以!你可以在设置面板中调整字体、字号、纸张大小、边距等参数。我们还提供浅色和深色两种主题。未来版本将支持更多自定义选项,如自定义 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) 的支持将在未来版本中考虑添加。
遇到问题如何获得支持?
你可以通过「关于我们」页面找到我们的联系邮箱。我们也欢迎你在 GitHub 上提交 Issue 或参与讨论。对于常见问题,建议先查阅本 FAQ 页面和使用教程。