UltKit

Markdown转PDF

上传 .md 或 .markdown 文件,即可得到排版好的PDF:# 变成标题,**bold** 变成粗体,竖线表格变成真正的表格。想把README、会议纪要或需求文档交给从没听说过Markdown的人,这是最快的办法。

转换为 PDF

或将DOC, DOCX, DOCM … 文件拖放到此处 ·

单个文件最大 95 MB· 最多 20 个文件· 30 分钟后删除

输出

文件在我们的服务器上处理,并在 30 分钟后删除。

使用方法

  1. 1

    上传 .md 文件

    添加一个 Markdown 文件,或一次最多添加 20 个,每个不超过 95 MB。如果文件在 GitHub 上,请打开文件,下载原始版本(raw)后再上传。

  2. 2

    检查页面和书签选项

    根据标题生成书签默认已开启,标题会显示在 PDF 侧边栏中。页边距默认为“正常”;如需打印,请在高级设置中把页面尺寸设为 A4 或 Letter。

  3. 3

    转换为PDF

    点击转换为 PDF,然后下载渲染好的文档。上传的文件和生成的 PDF 会在 30 分钟后删除。

答案

如何把 Markdown 转换成 PDF?

上传 .md 文件,点击转换为 PDF。转换器会先渲染 Markdown,所以 PDF 中显示的是排好版的标题、列表、链接、表格和代码,而不是原始符号。

Markdown、CommonMark与GFM:PDF支持哪些语法

  1. 2004

    Markdown

    John Gruber 在 Aaron Swartz 的参与下发布了语法说明和一个 Perl 脚本。这些规则留下了许多未明确的边缘情况。

  2. 2014

    CommonMark

    由 John MacFarlane 等人组成的团队发布了带测试用例、无歧义的规范,最初称为 Standard Markdown。

  3. 2016

    text/markdown

    RFC 7763 注册了 Markdown 文件的正式媒体类型。

  4. 2017

    GFM 规范

    GitHub 发布了 GitHub Flavored Markdown,它是 CommonMark 的严格超集,增加了表格、任务列表和删除线。

早期规则含糊,所以同一个文件在 GitHub、VS Code、Obsidian 和静态网站生成器中的渲染效果会略有不同。两个空行、用两个空格而不是四个空格嵌套的列表,或者 # 后面没有空格的标题,都可能改变结果。按 CommonMark 编写、需要表格时使用 GFM 表格的文件,几乎在所有地方渲染结果都一致,在这个转换器中也是如此。

如果你的文件其实是不含 Markdown 语法的普通笔记,可以用文本转 PDF页面,它会按输入的原样打印。如果内容已经是网页,HTML 转 PDF会保留网站自身的样式。

各种Markdown元素在PDF中的呈现效果

常见语法及其在页面上的效果
元素MarkdownPDF 中的效果
标题# 到 ######不同字号的标题;开启根据标题生成书签后,会出现在 PDF 侧边栏中
强调**bold**、*italic*、~~strike~~粗体、斜体和删除线文字
列表-, *, 1.项目符号列表和编号列表,按缩进嵌套
链接[label](https://…)可点击的文字;相对链接会失去目标
代码反引号和围栏 ``` 代码块带底色代码块中的等宽文字;每行请保持简短,以便适应页面宽度
表格GFM 管道表格带线表格;较宽的表格用横向页面效果更好
图片![alt](https://…)地址是完整的公开 URL 时才会显示

MD

Markdown

Markdown 是 John Gruber 于 2004 年创建的轻量级标记语法。它使用纯文本符号,例如用 # 表示标题、用 * 表示强调、用 - 表示列表,这些符号在原始文本中依然易读,也能干净地转换为 HTML。它是 README 文件、文档、维基、笔记应用和许多静态网站生成器的标准。它有多种方言,例如 CommonMark 和 GitHub Flavored Markdown,在表格等细节上有所不同。任何文本编辑器都能打开 .md 文件。

压缩方式
–
透明度
–
动画
–
发布年份
2004 · John Gruber
MD 转换器

PDF

便携式文档格式(PDF)

PDF 由 Adobe 于 1993 年创建,并在 2008 年成为开放的 ISO 32000 标准。它固定了文字、字体、图片和版式,使文档在每块屏幕和每台打印机上看起来都一样。PDF 可以包含表单、签名、链接、附件和可搜索文本,其中 PDF/A 变体用于长期归档。固定的版式使 PDF 难以编辑,而扫描版 PDF 除非经过 OCR,否则只包含图片。所有浏览器和操作系统都能打开。

压缩方式
–
透明度
支持
动画
不支持
发布年份
1993 · Adobe
PDF 转换器

Markdown 只有经过渲染器把符号变成格式后才算成品,而大多数收件人没有渲染器;PDF 呈现的是你想要的标题、表格和代码块,而不是井号和星号。

无法转换的Markdown扩展语法

图表、数学公式和Front Matter会保留为纯文本

Mermaid 图表、美元符号之间的 LaTeX 公式、文件开头的 YAML front matter 以及特定应用的嵌入语法,都是 CommonMark 和 GFM 规范之外的扩展。请把图表和公式导出为图片再链接,如果不想让 front matter 打印在第一页,请删除这一段。

Markdown转PDF常见问题

Markdown文件用哪种语法转PDF效果最好?

建议使用 CommonMark,再加上大多数编辑器都支持的 GitHub 扩展语法:管道表格、围栏代码块和删除线。只有某一个应用才能识别的语法,例如维基式链接,最有可能被当作纯文本输出。

Markdown转PDF时如何保留文件里的图片?

只会上传 .md 文件,所以像 ./img/chart.png 这样写成相对路径的图片找不到对应的文件。请用完整的 https:// 地址引用图片,或者把文本粘贴到包含图片的文档中,再转换那个文档。

可以转换从Obsidian或Notion导出的笔记吗?

可以,两者都能导出标准的 .md 文件。Notion 会把图片放在单独的文件夹里,Obsidian 笔记常用 [[wiki 链接]] 和嵌入语法,这些不属于标准 Markdown,会以原始文本显示,请先把它们替换成普通链接。

Markdown转PDF可以选择字体吗?

没有字体设置;转换器正文使用易读的默认字体,代码使用等宽字体。页面尺寸、方向、页边距、密码和 PDF/A 都可以在高级设置中设置。

Markdown内容应该发PDF还是Word文件?

如果希望对方按原样阅读、打印或签署,选 PDF。如果审阅者需要用修订功能编辑文字,可以用 Markdown 转 Word,得到标题和列表相同、可编辑的文档。