工具说明
Markdown 转 PDF 会先把轻量标记渲染成排版页面,再生成固定布局文档。标题、列表、引用、代码和表格会按当前样式输出,适合分享不希望继续编辑的说明、报告和笔记。
PDF 分页与网页流式布局不同,长代码块、宽表格、超大图片和孤行可能跨页不理想。相对资源路径、远程图片和特定平台扩展也不一定能加载,导出前应完整预览并调整 Markdown 结构。
使用步骤
整理 Markdown 源文
闭合代码围栏,检查标题层级、表格和图片链接。
预览分页效果
关注宽内容、段落断页、中文字体和页边距。
生成并打开 PDF
搜索文字并逐页检查链接、图片、页码和代码格式。
支持范围与限制
- 支持的语法
- 标题、列表、表格、代码块、引用、链接、图片、加粗斜体等常见 Markdown
- 分页
- 自动分页,长表格和长代码块可能被跨页切断
- 字体
- 使用浏览器可获得的字体,中英文混排正常。不同系统的输出排版可能有细微差别
- 图片
- 远程图片需要可访问才能渲染;本地路径的图片无法加载
- 不支持
- 自定义 CSS、页眉页脚、页码模板、目录自动生成
- 处理位置
- 在浏览器内生成 PDF,Markdown 内容不上传
典型使用场景
发布技术说明
把 README、操作指南或变更记录生成易分发 PDF。
提交格式固定的报告
用 Markdown 写作后输出不会因阅读器窗口改变的版本。
把 README 转成可归档的文档
项目说明和技术方案以 PDF 形式提交时,排版固定,接收方不需要 Markdown 渲染环境。
使用前需要知道的事
- 不同 Markdown 方言支持的表格、任务列表和 HTML 功能可能不同。
- 远程资源受网络和跨域限制,重要图片应确保在生成时可访问。
- 生成 PDF 后仍应检查无障碍阅读顺序、标题结构和链接文本。
相关概念
- Markdown renderer
- 把标记语法解析为标题、段落和其它结构的程序。
- page break
- 固定页面输出中从当前页切换到下一页的位置。