Imprint PDF

Imprint · 印记

Markdown 进，出版社级 PDF 出，自带 0–100 印刷级质检报告。

English · 简体中文 · 在线画廊与演示 · 本地生成指南

Imprint 是一个 AI 原生的中文印刷级 PDF 生成器。它把 Markdown 当成草稿，把 PDF 当成成品——按出版物的标准排版：宋体正文、黑体标题、首行缩进、标点避头尾、目录页码精确、表格跨页重复表头、代码不截断。生成之后，机器自动给这份 PDF 打分：0–100 印刷级评分，逐项给出证据。

在线演示可用性有限。 提交的 Markdown 会发送到临时托管服务器进行渲染；请勿上传私密或敏感文档。需要处理私密内容时，请按本地生成指南在本机运行。

快速开始（需先准备平台依赖）

# 方式一：npm 包装器（首次可能联网安装 Python 引擎）
npx imprint-pdf 论文.md

# 方式二：pip 安装（已发布到 PyPI）
pip install imprint-pdf
imprint 论文.md

# 常用命令
npx imprint-pdf --new report     # 从模板起稿
npx imprint-pdf --list-themes    # 24 套主题
npx imprint-pdf 论文.md --theme academic --out 论文.pdf

首次成功与平台依赖

以下仅用于已安装本源码的仓库根目录（pip 包不含顶层 examples）：先运行 python3 -m imprint --version，应输出 imprint 0.14.0；再运行 python3 -m imprint examples/sample.md --out sample.pdf 完成离线样例。需要 Python 3.10+、项目依赖，以及 WeasyPrint 的原生 Pango/GLib：macOS 用 Homebrew 安装 Pango，Debian/Ubuntu 安装 libpango-1.0-0 与 libpangoft2-1.0-0，Windows 安装当前 GTK3 runtime。中文字体需由使用者自行安装。

质检分数是本仓库检查项的可重复启发式评分，不是印刷厂认证；PDF/UA 行只检查 Tagged PDF 标记，并不等同于完整 PDF/UA 合规。正式发布仍需专用无障碍校验器和人工印前打样。

完整安装指南和平台矩阵见 首次成功指南。源码版本与注册表版本可能不同；发布前请分别核对 PyPI、npm 和 GitHub Release。

主题画廊（24 套 · 全部通过印刷级质检）

2段組み学術論文テンプレート

imprint --new paper を実行するだけで、2段組み学術論文を生成できます。要約／キーワードは段抜き、本文は2段組みでレイアウトされ、見出しがページ末尾に取り残されず、表が段をまたいで途切れず、行内数式も改行されません。

英語論文には imprint --new ieee を使います。IEEE スタイル（Times 10pt のコンパクトな2段組み＋IEEE ブルー）で、 lang: en により文書の言語タグが自動的に切り替わり、Abstract／Index Terms は段抜きになります。

公文書スタイルテンプレート（GB/T 9704 準拠を謳うものではありません）

imprint --new gongwen で公文書スタイルの草稿を生成します（GB/T 9704 の全項目に基づく検証は行っておらず、規格準拠を謳うものではありません）。 赤色の発信機関名、発文番号、赤色の区切り線（★）、ゴシック体の見出し、仿宋体の三号本文、 右揃えの署名と作成日を備えています。

テーマの変更は1行のコマンドでできます：imprint paper.md --theme wine。テーマを指定しなくてもスマートに変更されます——内容の雰囲気を自動分析してテーマを選び、その理由を説明します（例：週報には自動的に graphite、論文には自動的に academic を使用）。

Imprint を選ぶ理由

ほとんどの Markdown→PDF ツール（pandoc のデフォルト、md2pdf 系、Chrome の印刷機能）は、単に「テキストをページに流し込む」だけです。Imprint には次の3つの特長があります。

• 中国語の印刷品質——『中文排版需求』に厳密に準拠：行頭・行末禁則、1行目の2文字字下げ、中英混植の字間、孤立行の制御
• デザインシステムをテーマに——各テーマは DTCG デザイントークン（配色／フォントの組み合わせ／間隔／装飾）のセットです。テーマの変更は1行でできます
• 印刷品質の品質検査レポート——PDF の生成後に毎回自動で0〜100点の評価を行い、テキストの選択可否、フォントサブセットの埋め込み、句読点の違反、目次のページ番号、Tagged PDF のタグを検査します。証拠も確認できます

クイックスタート

pip install imprint-pdf
# 图表支持（可选）
pip install imprint-pdf[charts]
# MCP server（可选，Agent 一句话出报告）
pip install imprint-pdf[mcp]

imprint paper.md -o paper.pdf
imprint paper.md --theme sepia --compress
# 从模板起稿（报告/书籍/简历/技术文档/信函）
imprint --new report -o my_report.md
# 启动 MCP server（stdio），供 Claude Code / Cursor / DeepSeek Harness 等接入
imprint-mcp

出力の最後に品質検査レポートが表示されます。

印刷级质检报告
==============================================
 ✓ 文本可选              15.0/15.0   平均每页 722 字符
 ✓ 字体子集嵌入            15.0/15.0   5/5 字体已嵌入
 ✓ 元数据完整              3.0/3.0    标题「印记」
 ✓ 标点避头尾             15.0/15.0   0 违规
 ✓ 孤行寡行               9.0/9.0    0 处
 ✓ 目录页码              15.0/15.0   核对 15 条
 ✓ 页码存在               2.0/2.0    8/9 页含页码
 ✓ Tagged PDF 标记          3.0/3.0    Tagged PDF
 ✓ 主题字体生效             3.0/3.0    命中 songti
 ✓ 主题对比度              5.0/5.0    正文 17.0:1 …
 ✓ 缺字检测               5.0/5.0    无缺字回退
 ✓ 内容溢出               5.0/5.0    无内容越界
 ✓ 图片清晰度              5.0/5.0    全部达标
 ----------------------------------------------
 总分 100.0/100 · 等级 A+ · 9 页

特長

• 表紙＋目次：frontmatter の title / author / date から表紙を自動生成し、見出しからクリック可能な目次を自動生成します（ページ番号は正確です）
• スマートなテーマ変更：テーマを指定しない場合、見出し／キーワード／本文の特徴から自動でおすすめを選びます（理由も表示）。テーマを明示的に指定した場合は、そちらが優先されます
• テーマシステム：24種類のテーマ（下のギャラリーを参照）——モダンな雑誌／学術書／北欧ミニマル／目に優しい紙色／新聞の一面／柔らかなパステル／モノクロ／翡翠グリーン／コーヒーの暖かなブラウン／オーシャンブルー／ラベンダーパープル／桜ピンク／松林グリーン／ブルゴーニュワインレッド／グラファイトグレー／深夜のブルー系用紙（ダーク）／コーラルオレンジ／アンバーゴールド／ミントグリーン／砂漠の砂色／ミニマル（minimal）／線装本（ink、宣紙＋印章の赤）／赤頭公文書（gongwen）／IEEE 英語論文（ieee）。カスタムテーマは JSON ファイル1つで作成できます
• GitHub スタイルのアラート：> [!NOTE]／[!TIP]／[!WARNING]／[!IMPORTANT]／[!CAUTION] を印刷品質の色付きカードとして自動レンダリングします。examples/alerts.md を参照してください
• Mermaid 図表：```mermaid コードブロックをベクター画像に自動レンダリングします（中国語も正常に表示され、拡大縮小も無制限）。エンジンがインストールされていない場合は、コードブロックに適切にフォールバックします。examples/charts.md を参照してください
• 数式：$行内公式$／$$块级公式$$ をベクター SVG にレンダリングします（matplotlib mathtext を使用。数式フォントへの依存はありません）。examples/math.md を参照してください
• テンプレートシステム：imprint --new report|book|resume|techdoc|letter|paper|gongwen|ieee で草稿を一括生成できます。各テンプレートには用途に合った組版スタイルが用意されています（グラファイトグレーのレポート／ベージュの原稿／等幅フォントの履歴書／オーシャンブルーの技術文書／ラベンダーの手紙／2段組み学術論文／赤頭公文書／IEEE 英語論文）
• 画像圧縮：--compress で大きすぎる画像を自動的にダウンサンプリングして再エンコードします（実測で11.7MB → 1.4MB）
• フォントチェック：生成前に、テーマのフォントがローカル環境で使用可能か自動確認し、見つからない場合は明確に警告します
• 中国語の組版規則：行頭・行末禁則、1行目の字下げ、中英混植、英語段落の自動ハイフネーション
• 表のページまたぎ：ヘッダーを自動で繰り返し、行を分割しません
• コードのハイライト：Pygments による色付け。コード全体を次ページに送ることで分割を防ぎます
• グリフ欠落の検出：レンダリング後に LastResort/notdef へのフォールバック（豆腐文字）をスキャンし、脚注や矢印などの記号の欠落も自動で明らかにします
• タグ付き PDF：デフォルトで WeasyPrint の PDF/UA-1 出力モードを要求します。アクセシビリティの完全な準拠には、引き続き検証が必要です
• AI ネイティブ：CLI から1行のコマンドで実行できます。MCP サーバーを内蔵しています（pip install "imprint-pdf[mcp]" → imprint-mcp）。実際のツール名は render_markdown、list_themes_tool、validate_pdf_tool、new_document_tool です。Docker と Glama の事前手順についてはコンテナー接続ガイドを参照してください。
• コントラスト比の準拠：テーマの配色に基づいて WCAG のコントラスト比を計算します（本文 ≥7:1、小さい文字 ≥4.5:1、装飾 ≥3:1）

対応範囲

Imprint は Markdown の組版、テーマ、ヒューリスティックなチェックを組み合わせています。他のツールの機能は、バージョンやプラグインの設定によって異なります。本プロジェクトでは競合ツールを統制された条件でテストしていないため、絶対的な優劣の比較は行いません。

ドキュメント

• 完璧な PDF の基準——「完璧」の定義と合格基準
• 徹底的な参考資料一覧——各工程におけるコミュニティの選定と実測結果
• プロジェクトのストーリー · 草稿から完成品へ——開発の理由と、極限まで仕上げる方法（完成版 PDF）
• 品質ゲート（0〜100点）が必要な理由——品質検査は見せびらかすためではなく、文書の CI のためです

ロードマップ

• さらに多くのテーマ（24種類を公開済み：minimal / ink / gongwen / ieee など）
• npm での配布 npx imprint-pdf（公開済み）
• 2段組み／学術テンプレート（公開済み）
• PyPI での公開（レジストリのバージョンとソースは異なる場合があります）
• さらに多くの2段組みテンプレート（IEEE／公文書／診療記録など）

関連ツール

• falsify — AI エージェントのための科学的思考プロトコルです。完璧な PDF を組版する前に、falsify でその結論を検証しましょう。仮説 → 反証 → 証拠 → 確度を調整した判定。
• dsh-verify — エージェントが構築したアプリをブラウザーで検証して提供するためのツールです。実際のブラウザーテストにより、評価者には見えない出力の不具合を検出します。

ワンコマンドでインストール：npx skills add 263311487-ux/falsify · npx dsh-verify · npx imprint-pdf

ライセンス

MIT