Imprint treats Markdown as the draft and the PDF as the finished product. It typesets like a publishing house — serif body, first-line indents, kinsoku punctuation rules, exact TOC page numbers, repeating table headers — then scores every PDF 0–100 with evidence for each check.
中文印刷级排版 · 24 套主题 · 8 套模板 · 自带 0–100 质检报告 · 一个命令出片
# After Python, Pango and fonts are installed.
$ npx imprint-pdf paper.md
✓ 文本可选 15.0/15.0 · 字体嵌入 10.0/10.0 · 标点避头尾 10.0/10.0 · 目录页码 10.0/10.0 …
✓ 总分 100.0/100 · 等级 A+ · 9 页
Imprint is built for the AI-native workflow: you keep writing in Markdown, it handles everything that makes a document feel printed, and it supplies a machine-readable heuristic quality report.
Frontmatter sets title / author / theme / layout. Cover and clickable TOC are generated automatically.
Publisher rules: 2-em first-line indents, kinsoku line-breaking, widow/orphan control, cross-page tables with repeated headers, vector math & Mermaid charts.
14 checks — fonts, metadata, punctuation, TOC accuracy, contrast, glyphs, overflow, image DPI, Tagged PDF flag — each with evidence, printed to your terminal.
Each theme is a set of DTCG design tokens — palette, type pairing, spacing, decoration. The validator checks selected theme color pairs (body ≥ 7:1, small text ≥ 4.5:1); inspect your actual output. All thumbnails below are real rendered pages.
























Each template ships with its own typographic personality — imprint --new report gives you a graphite-gray business report; --new gongwen an official-document-style draft, not certified GB/T 9704 compliance; --new ieee an English two-column IEEE-style paper.
Graphite-gray business report
--new reportRice-paper book manuscript
--new bookMonospace CV, one page
--new resumeOcean-blue technical doc
--new techdocLavender formal letter
--new letterTwo-column academic paper
--new paperRed-header official document
--new gongwenIEEE-style English paper
--new ieeeEvery render runs 14 automated checks and prints a 0–100 report. The report describes implemented checks; it does not cover every layout or accessibility issue.
These files were generated by Imprint itself and scored by its own validator. Download and open them — scores are historical sample results; fonts and runtime can change the result.
Markdown rendering, 24 themes, optional diagrams, an MCP server, and 14 report checks (including an informational file-size check). Other tools vary by version and configuration; this is not a controlled competitor benchmark.
A 100/100 result means no deductions in these checks. It does not certify print quality or accessibility.
Imprint ships an MCP server (imprint-mcp) with four tools: render_markdown, list_themes, validate_pdf, new_document. Point Claude, Codex, Cursor or any MCP client at it and agents can produce print-grade PDFs directly.
pip install "imprint-pdf[mcp] @ git+https://github.com/263311487-ux/imprint-pdf.git"
imprint-mcp # stdio MCP server
The npm wrapper auto-installs the engine on first run (PyPI, with a GitHub fallback), so npx imprint-pdf requires Node plus Python 3.10+, Pango/GLib and appropriate fonts.
npx imprint-pdf paper.mdpip install "imprint-pdf @ git+…"pip install "imprint-pdf[mcp]"npx imprint-pdf paper.md --out paper.pdf
npx imprint-pdf --new report
npx imprint-pdf paper.md --theme academic
npx imprint-pdf paper.md --report qa.json
Submitted Markdown is sent to a temporary server for rendering. Do not upload private or sensitive documents. Availability and render limits may change; use the local guide for private files.
Imprint offers: cover and clickable TOC with exact page numbers, 2-em first-line indents, kinsoku line-breaking, widow/orphan control, tables that repeat their header across pages, code-block layout rules — then scores the output 0–100 with evidence for each check.
Because honesty is a feature. The gongwen template requires FangSong (仿宋) which ships with Windows but not macOS. On a machine without it, Imprint falls back to a serif font and deducts 3 points in the report — it tells you instead of pretending.
Python 3.10+, Pango/GLib and fonts are required. npx imprint-pdf auto-installs the engine on first run (pip with a GitHub fallback). The engine is a normal pip package for everyone else: pip install imprint-pdf.
Yes — it ships an MCP server (imprint-mcp) with render/list/validate/new tools, so agents can produce finished PDFs from a single sentence.
MIT licensed. The command-line renderer runs on your machine. The optional hosted demo sends submitted Markdown to its temporary rendering server.