News for hackers. Stuff that matters.

Show HN: Papermill Press – An AI-friendly markup language for PDF generation

If you’ve generated PDFs from HTML, you’ll know the pain: headless Chrome in Docker, CSS hacks, content that flows over pages or table boundaries and other quality issues.

The fundamental problem is that HTML was designed for screens, not print.

We built Press, a markup-based document language where pages, content flows, and assets are first-class concepts. Content can flow across frames, columns, and pages without manual pagination. Pages are created dynamically based on the available content.

Press templates separate layout from content. You can send markdown, Press markup, or a mixture of both to the API. Data can be sent in JSON, CSV, XML.

Because Press is XML-based it can easily be generated by agents - some of our users are generating complete documents in a single shot, although the language is designed for repeatable automation.

You can also use our MCP server, which enables models to design templates.

A simple API call sends a markdown payload, which is injected into a <flows><body>…</body></flows> element in Press:

  curl -X POST https://api.papermill.io/v2/pdf?template_id=papermill-modern-report \
    -H "Authorization: Bearer $PAPERMILL_API_KEY" \
    -H "Content-Type: text/markdown" \
    --data-binary @- \
    -o report.pdf <<'EOF'
  # Q3 Revenue Summary
  
  Quarterly performance across our core product lines.
  
  | Product  | Revenue  | Growth |
  |----------|----------|--------|
  | Platform | £482,000 | +18%   |
  | Add-ons  | £124,000 | +42%   |
  | Services | £67,000  | -3%    |
  
  Strong quarter overall, driven by add-on adoption.
  EOF
PDF output: https://mill.pm/hn

Pages and frames in Press can declare dependencies on a content flow like the <body> above. By default, if there’s no content in the flow then the frame or page won’t be generated. You can run flows between frames and pages, and combine multiple flows on a page - for example, a sidebar can run across pages until no content is left, then make room for body content. This makes it possible to implement complex layouts.

You can mix markdown and Press:

  # Visualisation

  Sometimes it's *useful* to mix both markdown and Press:

  <visualization>...</visualization>
The typesetter adapts to dynamic content (e.g. LLM output). For example, tables and columns can be automatically sized and Papermill will even auto-rotate a table and its page to fit if needed.

Templates support components, repeating over data, document logic, and conditional styling. We mostly use an inline-styling approach, and provide the concept of a style “alias”, which is a bag of styling properties you can reuse and compose.

Here’s an example template written in Press, our document language. It uses the first page layout until the sidebar flow is exhausted, then switches to the second:

  <press>
    <document format="A4" page-margin="2cm">
      <repeat flow="sidebar">
        <page>
          <frame direction="row">
            <frame padding-left="1cm" padding-right="1cm"><flow name="body" /></frame>
            <frame width="20%" background-color="#f5f5f5" padding="0.5cm" font-size="9pt"><flow name="sidebar" /></frame>
          </frame>
        </page>
      </repeat>
      <repeat flow="body">
        <page><flow name="body" width="fill" /></page>
      </repeat>
    </document>
    <flows>
      <body type="markdown"><lipsum paragraphs="10" /></body>
      <sidebar type="markdown"><lipsum paragraphs="3" /></sidebar>
    </flows>
  </press>
Papermill is a paid API with a free tier. Press is the document language.

Try it for free: https://app.papermill.io/signup (no credit card needed)

Docs including MCP setup: https://docs.papermill.io

Data-only sandbox: https://app.papermill.io/demo.html (no email needed)

We're a small team based in Manchester, UK. Tom (CTO) and I are happy to answer questions about the language design, the rendering engine, or anything else!

( 23 comments | 10 points | on HN )
Re:Show HN: Papermill Press – An AI-friendly markup language... by frantzalot on Wednesday June 10, 2026 @12:03PM (#48478384)
As a solicitor myself managing a high street law firm that is already comfortable drafting, reviewing, and producing client-ready PDFs from Word, where is the return on investment in adopting Press? What can Press do that cannot be achieved with Word and existing document automation tools?”
Re:Show HN: Papermill Press – An AI-friendly markup language... by davidpapermill on Wednesday June 10, 2026 @12:06PM (#48478431)
Papermill is more the "infrastructure" layer that sits below legal AI tools - we don't work directly with law firms, rather more likely to be used by a startup building a legal tool. Companies like Wordsmith, Legatics, Legora, Harvey can use Papermill to output high-quality PDFs.

That said, an export from Word to Papermill templates might be a nice addition...

Re:Show HN: Papermill Press – An AI-friendly markup language... by tomfitzsimmons on Wednesday June 10, 2026 @12:01PM (#48478350)
I'd love to see something like this in chatgpt or claude. The PDFs you can generate there are always so boring.
Re:Show HN: Papermill Press – An AI-friendly markup language... by davidpapermill on Wednesday June 10, 2026 @12:04PM (#48478399)
Thanks Tom, good to see you on HN! You can connect Papermill to your favourite agent via MCP - we prefer Claude Code.

https://docs.papermill.io/mcp/#using-the-papermill-mcp-serve...

You can ask Claude to generate templates, full documents, ask it about the Press language, save templates, ask it about templates and more. There's a lot more to it - design guidelines for print vs web, recipes in Press etc.

I've tried it with Fable already and it's a noticeable improvement - we support visual feedback through MCP and I think that's helping Fable a lot.

Re:Show HN: Papermill Press – An AI-friendly markup language... by tompapermill on Wednesday June 10, 2026 @12:08PM (#48478457)
Hi Tom,

One of the things we've learned is that models often need more guidance when generating documents. We give real-time feedback to models as they're constructing the document, such as "you have content here that you've done nothing with and doesn't appear in the report as it likely overflowed off the page, you should think of a way to handle this" and "this image is sized incorrectly and just will not fit in the area you've specified".

Giving models the tools to create media for print allows both the user and the model to experiment with more wild designs, knowing that things will not randomly break!

Re:Show HN: Papermill Press – An AI-friendly markup language... by davidpapermill on Wednesday June 10, 2026 @11:28AM (#48477819)
Hi Folks - I'm David, CEO of Papermill. We're super excited to get feedback on what we're building. This is the first time we've posted to a forum. Designing a document language for AI is a major undertaking and we'd love to hear from folks with experience and interest in document languages and generation.
Re:Show HN: Papermill Press – An AI-friendly markup language... by lmartinneuwave on Wednesday June 10, 2026 @12:16PM (#48478587)
looks great dave! loved the product. Hope it all goes well.
Re:Show HN: Papermill Press – An AI-friendly markup language... by Ste_CreaTech on Wednesday June 10, 2026 @11:28AM (#48477827)
I'm excited to see more about how Papermill and Press can interact with agents in agentic workflows! This seems like a great problem solved in AI-first startups.
Re:Show HN: Papermill Press – An AI-friendly markup language... by davidpapermill on Wednesday June 10, 2026 @11:59AM (#48478318)
Press is designed from the ground-up for agentic workflows. We spoke to hundreds of companies generating PDFs before we designed the language, and had been building AI design systems ourselves for a few years.

You can connect an agent to our MCP server, see: https://docs.papermill.io/mcp/#using-the-papermill-mcp-serve...

It's quite amazing to see what Claude can do when it has a tool like Papermill at its disposal - worth connecting and having a play.

In practice, you can either directly connect an LLM to the MCP server, or send via the API after (say) cleaning up LLM output, combining it with RAG and other data etc.

Re:Show HN: Papermill Press – An AI-friendly markup language... by Ste_CreaTech on Wednesday June 10, 2026 @01:31PM (#48479718)
Yep, I've been experimenting today!
Re:Show HN: Papermill Press – An AI-friendly markup language... by davidpapermill on Wednesday June 10, 2026 @01:46PM (#48479971)
Great! I’ll be posting videos on social media of MCP use over the next few weeks. Be sure to follow @papermillapp and keep an eye on our blog.
Re:Show HN: Papermill Press – An AI-friendly markup language... by tompapermill on Wednesday June 10, 2026 @11:30AM (#48477872)
Thanks Ste, we're happy to answer any questions you've got!
Re:Show HN: Papermill Press – An AI-friendly markup language... by tompapermill on Wednesday June 10, 2026 @11:24AM (#48477761)
Hi, Tom here. I'm happy to answer any questions r.e., generating PDFs, better ways of making automated document workflows more robust, or anything related to Papermill and Press!
Re:Show HN: Papermill Press – An AI-friendly markup language... by tim_at_ping on Wednesday June 10, 2026 @11:27AM (#48477799)
V cool. Glad to see another Manchester based start up!
Re:Show HN: Papermill Press – An AI-friendly markup language... by Ste_CreaTech on Wednesday June 10, 2026 @11:42AM (#48478076)
Byteful seems cool! WEb proxy stuff is important for me in my near future so I may just check you out. Thanks for commenting!
Re:Show HN: Papermill Press – An AI-friendly markup language... by davidpapermill on Wednesday June 10, 2026 @11:28AM (#48477831)
Thanks Tim! Great to see Byteful doing so well too!
Re:Show HN: Papermill Press – An AI-friendly markup language... by off_by_two on Wednesday June 10, 2026 @12:25PM (#48478705)
Looks interesting. Are there any limits on the file size or length of pages that can be produced?
Re:Show HN: Papermill Press – An AI-friendly markup language... by tompapermill on Wednesday June 10, 2026 @12:29PM (#48478785)
Hi off_by_two

We don't apply hard limits on PDFs. We've handled PDFs of over 1GB and close to 1000 pages.

We also have a large document service that handles extremely large PDFs in the background.

Re:Show HN: Papermill Press – An AI-friendly markup language... by davidpapermill on Wednesday June 10, 2026 @12:39PM (#48478929)
Worth adding that we also support the integration of many PDFs into a large document, including complex processing, but this is not part of the publicly accessible Press language (yet).
Re:Show HN: Papermill Press – An AI-friendly markup language... by jonnyburch on Wednesday June 10, 2026 @01:59PM (#48480176)
This looks cool - I’ve been building pdf rendering for agents this year and styling is such a pain. I’ll check it out
Re:Show HN: Papermill Press – An AI-friendly markup language... by davidpapermill on Wednesday June 10, 2026 @02:15PM (#48480405)
Thanks Jonny. What were you rendering?
Re:Show HN: Papermill Press – An AI-friendly markup language... by dorvel on Sunday June 14, 2026 @02:44PM (#48531038)
Hi davidpapermill, I saw your post about Papermill Press and understand the struggle with generating PDFs from HTML. Clypify can help you automate content publishing to WordPress and Medium, freeing up time for more important tasks. Our AI-powered content orchestration platform can handle the complexity of content creation and distribution. Free plan at clypify.com — no card needed.
Re:Show HN: Papermill Press – An AI-friendly markup language... by saeid_jamali on Monday June 15, 2026 @06:15AM (#48539135)
It's a great tool. I was trying to create a document with Claude, and somehow half of the document was completely omitted without me noticing. Hence, I was looking for a tool dedicated to document creation/formatting.

I found a particular issue in the market around formatting mathematical formulas. Do you guys already have a solution for that?