技术文档排版统一
团队用 Markdown 写 API 文档，每人编辑器主题不同，导出 PDF 时字体、行距、代码块背景色全不一致。交付甲方前必须整份统一样式。本工具支持自定义 CSS 主题，导入团队统一的样式文件后，所有 .md 文件批量转 PDF，代码高亮、标题层级、表格边框完全对齐，省去逐页手动调格式的 2 小时。
M A R K D O W N编辑 / 粘贴
预 览赤金大刊
导出矢量 PDF：点「导出 PDF（打印）」→ 浏览器打印对话框中选「另存为 PDF」，得到文字可选、中文清晰的矢量 PDF，按所选纸张与页边距排版。
隐私：解析、渲染、导出全程在浏览器本地完成，内容不上传。
就绪 · 左侧编辑，右侧实时预览
第一节
关于本工具
About写完一篇技术文档，复制到微信群里，格式全乱、代码块缩成一团。这个工具把 Markdown 转成 PDF，保留标题层级、代码高亮和表格边框，并允许替换字体与页边距。转换在浏览器本地完成，原始文件不会上传到任何服务器——适合需要向客户交付整洁文档的开发者，或希望把笔记归档为不可篡改格式的写作者。
使用场景
简历投递格式适配
用 Markdown 写的简历在本地预览完美，发到招聘系统后表格错位、列表缩进丢失。招聘方 HR 收到的 PDF 里项目经历挤成一团。本工具可自定义页边距、字体大小和列表间距，将简历转为 A4 标准排版 PDF，确保在任何系统打开时版式固定，项目时间、公司名称、技术栈三列对齐。
学术论文草稿共享
课题组用 Markdown 写论文初稿，导师习惯在 PDF 上批注。直接导出默认样式 PDF，公式编号靠左、参考文献字体偏小，导师反馈“排版乱”。本工具允许自定义正文、脚注、代码段样式，将论文转为符合期刊投稿模板的 PDF，行号标注、页眉页脚、参考文献悬挂缩进均按目标期刊要求设定。
产品手册多语言输出
产品经理用 Markdown 维护中英文双语说明书，每更新一次版本需手动调整两套 PDF 的标题字体和段落间距。本工具支持为不同语言版本分别绑定 CSS 主题：中文用宋体 12pt、英文用 Arial 11pt，标题加粗居中。一次导出两份 PDF，中英文排版各自符合阅读习惯，无需二次修改。
项目周报批量生成
每周五需向管理层提交 8 个项目的进度周报，每份包含表格、甘特图链接、风险标记。用 Markdown 写完后导出 PDF，表格内文字被截断，甘特图链接失效。本工具可自定义表格列宽、链接样式和页边距，将周报转为固定版式 PDF，表格自动换行、链接保留可点击状态，8 份报告 10 分钟内全部转完。
第二节
使用指南
Getting Started使用步骤
- 1在编辑区粘贴 Markdown 原文，右侧预览窗实时渲染排版效果，无需手动刷新
- 2点击「主题」下拉菜单切换预设样式（如 GitHub / 学术 / 极简），预览同步更新字体与配色
- 3勾选「页眉页脚」开关后，在弹出框内填写文档标题、页码格式与页脚文字，预览区即时显示位置
- 4点击「导出 PDF」按钮，浏览器直接触发下载，文件名默认取自文档首个 H1 标题
输入输出示例
| 输入 | 输出 | 说明 |
|---|---|---|
| ## 标题 这是一段**粗体**和*斜体*文本。 - 列表项1 - 列表项2 > 引用块 | 生成的PDF中：标题为黑体加粗，正文使用默认衬线字体，粗体/斜体样式正确保留，列表项带圆点缩进，引用块左侧有灰色竖线且字体倾斜。 | 常规：覆盖标题、粗斜体、列表、引用四种基础Markdown元素，验证排版引擎是否完整支持标准语法。 |
| | 左对齐 | 居中对齐 | 右对齐 | | :--- | :---: | ---: | | 单元格A | 单元格B | 单元格C | | 单元格D | 单元格E | 单元格F | | 生成的PDF中：表格边框为细实线，第一列左对齐，第二列居中对齐，第三列右对齐，单元格内文字自动换行。 | 常规：表格是Markdown转PDF的高频需求，验证对齐方式渲染是否准确，以及表格跨页时是否断裂。 |
| ```python print("Hello, 世界") ``` | 生成的PDF中：代码块使用等宽字体（如Courier New），背景为浅灰色，行号未显示（默认无行号），中文正常显示。 | 常规：代码块场景，验证等宽字体、背景色、中文编码支持。部分工具会丢失代码块中的中文或背景色。 |
| 这是一个非常长的段落，用于测试自动换行功能。该段落没有换行符，但长度远超A4纸宽度，应当自动折行到下一行，而不是被截断或溢出页面边界。重复内容：这是一个非常长的段落，用于测试自动换行功能。该段落没有换行符，但长度远超A4纸宽度，应当自动折行到下一行，而不是被截断或溢出页面边界。 | 生成的PDF中：段落自动在单词或字符边界换行，无截断，无水平滚动条，文字完全在页面内。 | 边界：超长段落无换行符，验证自动换行策略（英文按单词/中文按字符）及页面溢出保护。 |
| # 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题 | 生成的PDF中：一级标题字号最大（如24pt），逐级递减至六级标题（如12pt），各级标题均加粗，无多余缩进。 | 边界：六级标题全部使用，验证标题层级字号递减是否平滑，以及六级标题是否被误认为普通文本。 |
|  | 生成的PDF中：图片位置显示一个带红色叉号的占位框，框内文字为'图片加载失败'，无报错中断。 | 易错：图片链接失效时，工具是否优雅降级（显示占位符）还是直接报错或跳过？此示例暴露错误处理机制。 |
| 数学公式：$E=mc^2$ 行间公式： $$ \int_{a}^{b} f(x) \, dx $$ | 生成的PDF中：行内公式$E=mc^2$正常渲染为斜体拉丁字母和上标；行间公式居中显示，积分符号正确，无乱码。 | 易错：LaTeX数学公式支持并非所有Markdown转PDF工具都内置，此示例测试是否依赖外部库或直接渲染。 |
| --- 分隔线以上内容 *** 另一种分隔线 | 生成的PDF中：两条分隔线均为水平细实线，宽度占页面100%，上下间距一致，无多余空行。 | 边界：两种分隔线语法（---和***）是否渲染为相同样式，以及分隔线前后段落间距是否合理。 |
常见错误对照
1.本地图片路径未转义或未使用绝对路径
✗ 错误
✓ 修复
 或 ``Markdown 转 PDF 时，相对路径 `./image.png` 在浏览器沙箱中无法解析，导致图片丢失。需使用完整 URL 或绝对路径，或通过工具的上传功能嵌入图片。
2.表格内使用换行符导致解析失败
✗ 错误
| 列1 | 列2 |
| --- | --- |
| 第一行<br>第二行 | 数据 |✓ 修复
| 列1 | 列2 |
| --- | --- |
| 第一行<br>第二行 | 数据 |Markdown 标准表格不支持 `<br>` 标签，部分渲染器会忽略或破坏表格结构。应改用多行文本（如 ` `）或拆分为多个表格。
3.代码块语言标识错误导致语法高亮失效
✗ 错误
```javascrip
console.log('hello');
```✓ 修复
```javascript
console.log('hello');
```语言标识必须使用规范名称（如 `javascript` 而非 `javascrip`），否则高亮引擎无法识别，代码块会显示为纯文本。
4.嵌套列表缩进不一致导致层级混乱
✗ 错误
- 一级
- 二级
- 三级
- 二级缩进不对齐✓ 修复
- 一级
- 二级
- 三级
- 二级缩进对齐Markdown 列表层级依赖缩进空格数（通常 2 或 4 空格），不一致的缩进会导致子列表被错误解析为同级。
5.特殊字符（如 `#`、`*`）未转义导致格式异常
✗ 错误
标题中带 # 号：C# 教程✓ 修复
标题中带 # 号：C\# 教程`#` 在行首会被识别为标题标记，`*` 会被识别为强调。在非格式位置出现这些字符时，必须用反斜杠转义。
6.使用非标准扩展语法（如 LaTeX 公式）但工具不支持
✗ 错误
$$\int_{0}^{1} x^2 dx$$✓ 修复
使用工具支持的公式语法（如 `$\int_{0}^{1} x^2 dx$` 或图片形式）本工具基于标准 Markdown 渲染，不支持 LaTeX 扩展语法。直接写 `$$...$$` 会被当作普通文本显示，而非渲染为公式。
7.YAML 元数据格式错误导致页面信息丢失
✗ 错误
---
title: 我的文档
author: 张三
---✓ 修复
---
title: 我的文档
author: 张三
---YAML 元数据必须严格缩进（键值对无多余空格），且结束标记 `---` 独占一行。错误格式会导致标题、作者等信息不被解析。
8.引用块内嵌套代码块未正确处理
✗ 错误
> 引用内容
> ```
> 代码行
> ```✓ 修复
> 引用内容
>
> ```
> 代码行
> ```引用块内的代码块需在 `>` 后空一行，否则代码块标记会被视为引用内容的一部分，导致解析错误。
第三节
工作原理
How It Works核心公式
页面高度 = 行数 × (字体大小 × 行高倍数) + 页边距 × 2
变量说明
行数Markdown 正文总行数字体大小主题设定的正文字号，单位 pt行高倍数行间距倍数，如 1.5 表示 1.5 倍行距页边距上下页边距之和，单位 pt
示例
一篇 Markdown 有 30 行正文，字体大小 12 pt，行高倍数 1.5，上下页边距各 36 pt：页面高度 = 30 × (12 × 1.5) + 36 × 2 = 30 × 18 + 72 = 540 + 72 = 612 pt，约 21.6 cm，适合 A4 纵向排版。
用户输入
本地处理
渲染输出
结果下载
第五节
常见问题
Q & A问我写的 Markdown 里用了很多自定义的 CSS 类名，这个工具能保留吗？＋
答
保留不了。本工具只解析标准 Markdown 语法（标题、列表、代码块、加粗等），不处理 HTML 内联样式或自定义 CSS 类。如果页面里有 `<div class="my-box">`，转换时会被当作普通文本或直接丢弃。建议先用纯 Markdown 写内容，排版样式通过工具内置的「主题」功能统一设置——有 6 种预设主题可选，也能微调字体、行高、页边距。
问为什么我转出来的 PDF 里表格的边框没了？＋
答
Markdown 原生表格本身就不带边框，它只是用竖线和横线表示结构。本工具渲染时默认按简约风格处理，不自动加表格线框。如果表格需要可见边框，可以在转换前进入「自定义主题」→「表格样式」，把「边框宽度」设为 1px 或以上。另外，表格内如果用了合并单元格语法（如 `||`），目前也不支持，会拆成多行。
问转出来的 PDF 里中文显示成方框乱码了怎么办？＋
答
通常是字体缺失。Markdown 本身不嵌字体，PDF 渲染依赖服务端字体库。本工具内置了「思源宋体」和「Noto Sans CJK」两套中文字体，默认使用前者。如果手动选了其他字体（如系统里没有的中文字体），就会回退成默认英文字体导致乱码。建议在「主题」→「字体」下拉框里选内置的中文字体，不要填自定义字体名称。
问我批量转 50 个 markdown 文件，这个工具有没有批量上传功能？＋
答
没有。当前版本只支持一次上传或粘贴一个 Markdown 文件。如果手头有几十个文件要转，建议用命令行工具（如 Pandoc）批量处理，它支持 `pandoc *.md -o output.pdf` 这种模式。本工具定位是单次快速转换 + 排版微调，适合临时需要一份排版好看的 PDF 的场景，不适合大批量流水线作业。
问转出来的 PDF 里代码块背景色太浅，能不能调深一点？＋
答
可以。在「自定义主题」→「代码块」设置里，有「背景色」和「文字色」两个颜色选择器，支持十六进制色值（如 #2d2d2d）。默认是浅灰背景，改成深色后记得同步把文字色改成白色或亮色，否则深底深字看不清。另外，如果代码里用了语法高亮（如 ```python），高亮颜色也会跟着主题整体色调变化，目前不支持单独调某个关键词的颜色。
问为什么我转出来的 PDF 里图片特别模糊？＋
答
Markdown 里的图片如果用的是网络链接（如 ``），原图分辨率本身就低，PDF 渲染时不会自动放大。建议把原图下载到本地，用 `` 方式上传（本工具支持拖拽图片到编辑区），上传时工具会保持原图像素。如果原图是 72dpi 的屏幕截图，放大后依然会糊，这是源文件的问题。
问这个工具和直接用 Typora 导出 PDF 有什么区别？＋
答
Typora 是本地编辑器，导出 PDF 时用的字体、页边距、页眉页脚都依赖你本机安装的配置，换台电脑就可能走样。本工具是纯浏览器端 + 服务端渲染，所有样式由服务端统一控制，导出结果在不同设备上打开完全一致。另外本工具支持「页边距微调」和「页眉页脚自定义」，Typora 免费版没有这些选项。缺点是必须联网，不能离线用。
问转出来的 PDF 文件太大了（几十 MB），能压缩吗？＋
答
目前工具没有内置压缩功能。PDF 体积大通常是因为嵌入了高清图片或所有字体都被完整打包了。可以手动优化：先把 Markdown 里的图片用工具压缩到 150dpi 以下再上传；字体方面，在「主题」里选「仅嵌入常用字符」选项（如果有），能减少字体文件体积。如果最终文件还是大，建议用第三方 PDF 压缩工具二次处理。
隐私保证所有计算与处理均在你的浏览器本地完成，输入数据不会上传服务器，也不会保存或共享。