{
  "markdown": "<!-- mcp-name: io.github.263311487-ux/imprint-pdf -->\n# Imprint · 印记\n\n> **Markdown 进，出版社级 PDF 出，自带 0–100 印刷级质检报告。**\n\n<p align=\"center\">\n  <a href=\"https://263311487-ux.github.io/imprint-pdf/\"><img src=\"docs/social-preview.png\" alt=\"Imprint · 印记 — Markdown 进，出版社级 PDF 出\"></a>\n</p>\n\n[English](README.en.md) · [简体中文](README.md) · [✨ 在线画廊 / Live showcase](https://263311487-ux.github.io/imprint-pdf/) · [▶ 在线试玩 / Live demo](https://263311487-ux.github.io/imprint-pdf/#live)\n\nImprint 是一个 AI 原生的中文印刷级 PDF 生成器。它把 Markdown 当成草稿，把 PDF 当成成品——按出版物的标准排版：宋体正文、黑体标题、首行缩进、标点避头尾、目录页码精确、表格跨页重复表头、代码不截断。生成之后，机器自动给这份 PDF 打分：**0–100 印刷级评分，逐项给出证据**。\n\n<p align=\"center\">\n  <img alt=\"PyPI\" src=\"https://img.shields.io/pypi/v/imprint-pdf.svg\">\n  <img alt=\"npm\" src=\"https://img.shields.io/npm/v/imprint-pdf.svg\">\n  <img alt=\"Python\" src=\"https://img.shields.io/pypi/pyversions/imprint-pdf.svg\">\n  <img alt=\"License\" src=\"https://img.shields.io/pypi/l/imprint-pdf.svg\">\n  <img alt=\"Downloads\" src=\"https://img.shields.io/pypi/dm/imprint-pdf.svg\">\n  <img alt=\"CI\" src=\"https://github.com/263311487-ux/imprint-pdf/actions/workflows/ci.yml/badge.svg\">\n  <img alt=\"Stars\" src=\"https://img.shields.io/github/stars/263311487-ux/imprint-pdf\">\n</p>\n\n> **▶ 不想装？直接在线试玩：** [在浏览器里粘贴 Markdown → 生成印刷级 PDF + 0–100 质检分](https://263311487-ux.github.io/imprint-pdf/#live)（免费，限 20 次/小时/IP）\n\n\n## 快速开始（零配置）\n\n```bash\n# 方式一：一行命令（自动安装引擎，跨平台）\nnpx imprint-pdf 论文.md\n\n# 方式二：pip 安装（已发布到 PyPI）\npip install imprint-pdf\nimprint 论文.md\n\n# 常用命令\nnpx imprint-pdf --new report     # 从模板起稿\nnpx imprint-pdf --list-themes    # 24 套主题\nnpx imprint-pdf 论文.md --theme academic --out 论文.pdf\n```\n\n![封面](examples/qa/sample-01.png)\n\n![目录](examples/qa/sample-02.png)\n\n![正文](examples/qa/sample-04.png)\n\n![提示框](examples/qa/alerts-03.png)\n\n![mermaid 流程图](examples/qa/charts-03.png)\n\n## 主题画廊（24 套 · 全部通过印刷级质检）\n\n<p align=\"center\">\n<img src=\"examples/qa/modern-01.png\" width=\"150\" alt=\"modern\"/>\n<img src=\"examples/qa/academic-01.png\" width=\"150\" alt=\"academic\"/>\n<img src=\"examples/qa/nord-01.png\" width=\"150\" alt=\"nord\"/>\n<img src=\"examples/qa/sepia-01.png\" width=\"150\" alt=\"sepia\"/>\n<img src=\"examples/qa/newspaper-01.png\" width=\"150\" alt=\"newspaper\"/>\n</p>\n<p align=\"center\">\n<img src=\"examples/qa/catppuccin-01.png\" width=\"150\" alt=\"catppuccin\"/>\n<img src=\"examples/qa/mono-01.png\" width=\"150\" alt=\"mono\"/>\n<img src=\"examples/qa/jade-01.png\" width=\"150\" alt=\"jade\"/>\n<img src=\"examples/qa/coffee-01.png\" width=\"150\" alt=\"coffee\"/>\n<img src=\"examples/qa/ocean-01.png\" width=\"150\" alt=\"ocean\"/>\n</p>\n<p align=\"center\">\n<img src=\"examples/qa/lavender-01.png\" width=\"150\" alt=\"lavender\"/>\n<img src=\"examples/qa/rose-01.png\" width=\"150\" alt=\"rose\"/>\n<img src=\"examples/qa/pine-01.png\" width=\"150\" alt=\"pine\"/>\n<img src=\"examples/qa/wine-01.png\" width=\"150\" alt=\"wine\"/>\n<img src=\"examples/qa/graphite-01.png\" width=\"150\" alt=\"graphite\"/>\n</p>\n<p align=\"center\">\n<img src=\"examples/qa/midnight-01.png\" width=\"150\" alt=\"midnight\"/>\n<img src=\"examples/qa/coral-01.png\" width=\"150\" alt=\"coral\"/>\n<img src=\"examples/qa/amber-01.png\" width=\"150\" alt=\"amber\"/>\n<img src=\"examples/qa/mint-01.png\" width=\"150\" alt=\"mint\"/>\n<img src=\"examples/qa/sand-01.png\" width=\"150\" alt=\"sand\"/>\n</p>\n<p align=\"center\">\n<img src=\"examples/qa/minimal-01.png\" width=\"150\" alt=\"minimal\"/>\n<img src=\"examples/qa/ink-01.png\" width=\"150\" alt=\"ink\"/>\n<img src=\"examples/qa/gongwen-01.png\" width=\"150\" alt=\"gongwen 公文\"/>\n<img src=\"examples/qa/ieee-03.png\" width=\"150\" alt=\"ieee 英文论文\"/>\n</p>\n\n## 双栏学术论文模板\n\n`imprint --new paper` 一键生成双栏学术论文：摘要/关键词通栏，正文双栏排版，标题不落页尾、表格不跨栏截断、行内公式不断行。\n\n<p align=\"center\">\n<img src=\"examples/qa/paper-03.png\" width=\"260\" alt=\"paper 双栏正文\"/>\n<img src=\"examples/qa/paper-04.png\" width=\"260\" alt=\"paper 双栏图表\"/>\n</p>\n\n英文论文用 `imprint --new ieee`：IEEE 风格（Times 10pt 紧凑双栏 + IEEE 蓝），\n`lang: en` 自动切换文档语言标签，Abstract / Index Terms 通栏。\n\n<p align=\"center\">\n<img src=\"examples/qa/ieee-03.png\" width=\"300\" alt=\"ieee 双栏英文论文\"/>\n</p>\n\n## 党政机关公文（GB/T 9704 红头文件）\n\n`imprint --new gongwen` 一键生成符合《党政机关公文格式》的红头文件：\n红色发文机关标志、发文字号、红色分隔线（★）、黑体标题、仿宋三号正文、\n右对齐落款与成文日期。\n\n<p align=\"center\">\n<img src=\"examples/qa/gongwen-01.png\" width=\"300\" alt=\"gongwen 红头文件\"/>\n</p>\n\n换肤 = 一行命令：`imprint paper.md --theme wine`；**不指定也会智能换肤**——自动分析内容气质选主题并说明理由（如周报自动用 `graphite`，论文自动用 `academic`）。\n\n## 为什么是 Imprint\n\n大多数 Markdown→PDF 工具（pandoc 默认、md2pdf 系、Chrome 打印）只是\"把文字倒进页面\"。Imprint 的三个差异点：\n\n- **中文印刷级**——严格按《中文排版需求》：避头尾禁则、首行缩进 2 字符、中英文混排字距、孤行寡行控制\n- **设计系统即主题**——每套主题是一组 DTCG 设计令牌（色板/字体配对/间距/装饰），换肤 = 换一行\n- **印刷级质检报告**——每个 PDF 生成后自动评分 0–100，检查文本可选、字体子集嵌入、标点违规、目录页码、PDF/UA 无障碍标签，证据可查\n\n## 快速开始\n\n```bash\npip install imprint-pdf\n# 图表支持（可选）\npip install imprint-pdf[charts]\n# MCP server（可选，Agent 一句话出报告）\npip install imprint-pdf[mcp]\n\nimprint paper.md -o paper.pdf\nimprint paper.md --theme sepia --compress\n# 从模板起稿（报告/书籍/简历/技术文档/信函）\nimprint --new report -o my_report.md\n# 启动 MCP server（stdio），供 Claude Code / Cursor / DeepSeek Harness 等接入\nimprint-mcp\n```\n\n输出结尾是一张质检报告：\n\n```\n印刷级质检报告\n==============================================\n ✓ 文本可选              15.0/15.0   平均每页 722 字符\n ✓ 字体子集嵌入            15.0/15.0   5/5 字体已嵌入\n ✓ 元数据完整              3.0/3.0    标题「印记」\n ✓ 标点避头尾             15.0/15.0   0 违规\n ✓ 孤行寡行               9.0/9.0    0 处\n ✓ 目录页码              15.0/15.0   核对 15 条\n ✓ 页码存在               2.0/2.0    8/9 页含页码\n ✓ PDF/UA 标签          3.0/3.0    Tagged PDF\n ✓ 主题字体生效             3.0/3.0    命中 songti\n ✓ 主题对比度              5.0/5.0    正文 17.0:1 …\n ✓ 缺字检测               5.0/5.0    无缺字回退\n ✓ 内容溢出               5.0/5.0    无内容越界\n ✓ 图片清晰度              5.0/5.0    全部达标\n ----------------------------------------------\n 总分 100.0/100 · 等级 A+ · 9 页\n```\n\n## 特性\n\n- **封面 + 目录**：frontmatter 里的 `title / author / date` 自动生成封面，标题自动生成可点击目录（页码精确）\n- **智能换肤**：不指定主题时，按标题/关键词/正文信号自动推荐（含理由）；显式指定优先\n- **主题系统**：24 套主题（见下方画廊）——现代杂志 / 学术书卷 / 北欧极简 / 护眼纸色 / 报纸头版 / 柔和粉彩 / 纯黑白 / 玉石绿 / 咖啡暖棕 / 海洋蓝 / 薰衣草紫 / 樱粉 / 松林绿 / 勃艮第酒红 / 石墨灰 / 深夜蓝纸（暗色）/ 珊瑚橙 / 琥珀金 / 薄荷青 / 沙漠沙色 / **极简（minimal）** / **线装书（ink，宣纸+印章红）** / **红头公文（gongwen）** / **IEEE 英文论文（ieee）**，自定义主题 = 一个 JSON 文件\n- **GitHub 风格提示框**：`> [!NOTE]` / `[!TIP]` / `[!WARNING]` / `[!IMPORTANT]` / `[!CAUTION]` 自动渲染为印刷级彩色提示卡，见 `examples/alerts.md`\n- **Mermaid 图表**：` ```mermaid ` 代码块自动渲染为矢量图（中文正常、无限缩放），未装引擎时优雅回退代码块，见 `examples/charts.md`\n- **数学公式**：`$行内公式$` / `$$块级公式$$` 渲染为矢量 SVG（matplotlib mathtext，无数学字体依赖），见 `examples/math.md`\n- **模板系统**：`imprint --new report|book|resume|techdoc|letter|paper|gongwen|ieee` 一键起稿，模板自带对应排版气质（石墨灰报告 / 米黄书稿 / 等宽简历 / 海洋蓝技术文档 / 薰衣草信函 / 双栏学术论文 / 红头公文 / IEEE 英文论文）\n- **图片压缩**：`--compress` 自动降采样超大图并重编码（实测 11.7MB → 1.4MB）\n- **字体体检**：生成前自动检查主题字体本机是否可用，缺失时明确警告\n- **中文规范**：避头尾禁则、首行缩进、中英文混排、英文段落自动连字\n- **表格跨页**：表头自动重复、行不截断\n- **代码高亮**：Pygments 着色、整体换页不截断\n- **缺字检测**：渲染后扫描 LastResort/notdef 回退（豆腐块），脚注、箭头等符号缺字自动暴露\n- **PDF/UA**：默认输出无障碍标签版\n- **AI 原生**：CLI 一行命令；内置 MCP server（`pip install \"imprint-pdf[mcp]\"` → `imprint-mcp`），Agent 一句话出报告（tools: render_markdown / list_themes / validate_pdf / new_document）\n- **对比度合规**：每套主题自动通过 WCAG 印刷检查（正文 ≥7:1、小字 ≥4.5:1、装饰 ≥3:1）\n\n## 对比\n\n| | pandoc 默认 | Chrome 打印 | Imprint |\n|---|---|---|---|\n| 中文印刷级 | 弱 | 弱 | **按规范** |\n| 设计系统主题 | 无 | 无 | **DTCG tokens** |\n| 质检报告 0–100 | 无 | 无 | **自带** |\n| 数学公式 | 插件级 | 无 | **矢量内嵌** |\n| 模板起稿 | 无 | 无 | **8 套内置** |\n| 双栏学术排版 | 无 | 无 | **内置** |\n| 公文格式（红头文件） | 无 | 无 | **内置** |\n| WCAG 对比度检查 | 无 | 无 | **内置** |\n| PDF/UA 无障碍 | 手动 | 无 | **默认** |\n\n## 文档\n\n- [完美 PDF 标准](docs/完美PDF标准.md)——\"完美\"的定义与验收门槛\n- [极致借鉴清单](docs/极致借鉴清单_技术选型_20260819.md)——每个环节的社区选型与实测结论\n- [项目故事 · 从草稿到成品](docs/skill-report.md)——为什么做、怎么做到极致（[成品 PDF](https://263311487-ux.github.io/imprint-pdf/skill-report.pdf)）\n- [为什么需要质检门（0-100 分）](docs/why-quality-gate.md)——质检不是炫技，是文档的 CI\n\n## 路线图\n\n- 更多主题（24 套已上线：minimal / ink / gongwen / ieee 等）\n- npm 分发 `npx imprint`（已上线）\n- 双栏 / 学术模板（已上线）\n- [x] PyPI 发布（已上线 0.11.0）\n- 更多双栏模板（IEEE / 公文 / 病历等）\n\n## Related tools\n\n- [**falsify**](https://github.com/263311487-ux/falsify) — the scientific thinking protocol for AI agents. Before you typeset the perfect PDF, let falsify check the conclusion it presents: hypothesis → falsify → evidence → calibrated verdict.\n- [**dsh-verify**](https://github.com/263311487-ux/dsh-verify) — browser-verified delivery for agent-built apps: real-browser tests that catch broken output a judge cannot see.\n\nOne-command installs: `npx skills add 263311487-ux/falsify` · `npx dsh-verify` · `npx imprint`\n\n## License\n\nMIT\n",
  "bytes": 8308,
  "sha": "ebe738bf42962de58f724a013c670adcdb77aa79f8cab93e7b50b6fed1a06458",
  "repo_slug": "263311487-ux/imprint-pdf",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_263311487_ux_imprint_pdf_3ff726ae/readme"
}