使命
使命
让任何有浏览器的人都能把 Markdown 变成干净的 PDF，无需账号、订阅或上传。让转换过程保持可理解：用户应该能看到文档、选择主题，并清楚知道将要打印什么。
关于 md2pdf
缘起
md2pdf 始于一个常见问题：文档在屏幕上读起来很舒服，但一到发送、归档或打印的时候就会散架。
Markdown 一直很便携，直到对方要求 PDF。浏览器的打印对话框保留的是页面，不是文档：导航会混进来，相对图片会失效，宽代码块会被裁掉，表格会在尴尬的位置断开。桌面转换器能解决一部分问题，但通常要求安装、注册账号或上传到服务器。
md2pdf 选择了一条更窄的路。它读取 Markdown，解析仓库相对资源，在浏览器中渲染 GitHub 风格 Markdown，清理结果，应用打印样式，然后交给浏览器自己的 PDF 引擎。除非用户要求获取公开 README，源文件不会离开设备。
愿景
愿景
一个普通文档不需要专有桌面应用或转换服务就能便携的 web。Markdown 已经可读、可比较、可长期保存；PDF 应该是忠实的出口，而不是另一个封闭空间。
制作者
Girish Lade
md2pdf 创作者 · LadeStack
Girish Lade 在 LadeStack 构建 md2pdf。他负责转换器、打印主题、文档书籍流程以及本站的多语言版本。
这个项目刻意保持小而自足：静态 Astro 前端、仅在浏览器中运行的转换代码，以及验证输出而不是承诺输出的测试套件。
本页的肖像位置留给真实照片。在添加照片之前，组件显示品牌字母组合，而不是生成图片或图库照片。
产品如何构建
产品如何构建
浏览器优先
Markdown 解析、清理、目录生成、打印布局和 PDF 组装都在访客设备上运行。站点是静态的，没有应用后端。
小而明确的限制
单个文件上限 2 MB。文档书籍最多 30 个 Markdown 文件，单文件 750 KB，总计 6 MB，API 请求数量也有上限。
打印就是输出
最终 PDF 来自浏览器原生打印引擎。md2pdf 提供清理后的文档和打印样式，并不假装自己是 PDF 渲染引擎。
九种语言
界面、指南和本页提供英语、西班牙语、日语、韩语、简体中文、俄语、土耳其语、法语和巴西葡萄牙语版本。
如实说明的成果
如实说明的成果
这些是已经交付的能力，不是路线图承诺。
- 导入公开 GitHub README，自动发现默认分支，并重写仓库相对的图片和链接。
- Markdown 粘贴、上传和示例流程，支持 GitHub 风格表格、任务列表和围栏代码。
- 四种打印主题：Clean、Business、Academic 和 Dark。
- 为三个或更多标题的文档自动生成目录。
- 多文件文档书籍，包含封面、有序章节、可搜索选择和打印隔离。
- 逐章 PDF 导出和 ZIP 下载，带文件大小与数量限制。
- 界面、文章和本页的九种本地化版本。
- 无需账号，本地或粘贴的 Markdown 不会上传，也没有服务器端渲染器。
适合谁
适合谁
当文档比工具链更重要时，md2pdf 就有用。
学生和教师
把课程笔记、作业和阅读材料变成可提交或打印的 PDF。
开发者和技术写作者
无需安装转换器，就能导出 README、RFC 或一组文档章节。
顾问和小团队
不必把 Markdown 发给第三方服务，就能把干净文档交给客户。
归档人员
为可能在上游变化或消失的文档保留一份可读、分页的副本。
隐私
本地文件和粘贴的 Markdown 在浏览器中读取，不会上传。获取公开 GitHub 内容时，会为 README 及其图片向 GitHub 发出匿名请求；不支持私有仓库。没有账号，也没有与文档关联的转换分析。
无障碍
页面使用语义化地标、带标签的控件、可见的焦点样式，以及能保留当前路径的语言切换器。动效有限，并尊重减少动态效果的偏好。打印样式让标题与内容保持在一起，并尽可能避免代码块、表格和图片跨页断开。无障碍被视为持续工作，而不是一次性声明。
归属
归属
md2pdf 是 LadeStack 的产品。产品名称、站点和已发布的各语言版本归 LadeStack 所有。源代码仓库公开在 github.com/girishlade111/ReadmePDF；产品名为 md2pdf，仓库保留原名。md2pdf 可免费使用。
联系
联系
欢迎提出问题、更正和无障碍报告。电子邮件最可靠；GitHub issue 是公开且可搜索的。
- 电子邮件 admin@ladestack.in
- GitHub github.com/girishlade111
- LinkedIn linkedin.com/in/girish-lade
- LadeStack ladestack.in
放入文档，取出 PDF。
无需账号。本地文件不会上传。从示例开始，粘贴自己的 Markdown，或获取公开 README。