FreeMD2PDF.com
English

README to PDF: typeset in your browser.

Paste a README.md or drop the file here and download it as a typeset PDF, with its tables, code blocks and Mermaid diagrams. Nothing is uploaded.

Source · .md Drop a .md file or images here
Proof A4 · page breaks follow the downloaded PDF Live
PDF engine on standby
About Free MD2PDF

README to PDF

GitHub renders a README beautifully, but it has no “download as PDF”. Printing the repository page from the browser gives you the file list, the sidebar and the navigation along with the text, and page breaks wherever they happen to fall. What you usually want is the README itself as a document: to attach to a proposal, hand to a reviewer or read on paper.

Here the Markdown is typeset as a real document. Headings become PDF bookmarks, tables keep their alignment, code blocks are highlighted, and ```mermaid blocks, which GitHub also renders, become vector diagrams. Formulas in $…$ work as they do on GitHub.

How to convert a README to PDF

  1. Get the Markdown. On GitHub, open README.md, click Raw and copy the text, or use the file from your clone of the repository.
  2. Paste or drop it here. Paste into the editor, or drop the README.md file anywhere on the page.
  3. Drop in its images. Drag the image files the README uses onto the page; a path such as docs/screenshot.png is matched by its file name.
  4. Download the PDF. Press Download PDF, or Print to send the same PDF to a printer.

What comes through

GitHub-style tables with column alignment, fenced code with syntax highlighting, task lists, footnotes, nested lists, links that stay clickable, and Mermaid flowcharts, sequence diagrams and the other types, drawn as vectors with selectable text. Switch on Contents under Layout for a table of contents; a wide or tall diagram is fitted to the page rather than cut off.

Images: drag them in

The page never contacts another server, so it does not fetch images from the web. Images stored in the repository are easy: drop the files onto the page and every reference to them, whatever folder the README names, is filled in. Images that live elsewhere, including the badges from shields.io at the top of many READMEs, show up in the PDF as a short “image unavailable” note; delete those lines, or download the image and drop it in.

What does not carry over

Raw HTML is not rendered: a centred <p align="center"> header, an <img> tag or a collapsible <details> block appears as text, so rewrite those parts in plain Markdown. GitHub’s > [!NOTE] alerts become ordinary quotes, :rocket: shortcodes stay as text, and emoji have no font here, so they print as empty boxes (the page tells you which characters are affected).

Frequently asked questions

How do I convert a GitHub README to PDF?

Open the README on GitHub, click Raw, copy everything and paste it into the editor on this page, then press Download PDF. If you have the repository on your computer, drop README.md onto the page instead.

Why are the images missing from my PDF?

Relative images such as docs/architecture.png are files in the repository, and this page cannot see your repository: drop the image files onto the page and they are embedded. Images referenced by a web address, badges included, are never fetched, because nothing here is allowed to contact another server.

Are Mermaid diagrams in the README rendered?

Yes. ```mermaid blocks are drawn in your browser and embedded as vector graphics, the same diagrams GitHub shows. A diagram with a syntax error appears as a box with the error message and line, and the rest of the PDF is unaffected.

Can I convert a README from a private repository?

Yes. The text is typeset in this browser tab and never uploaded, so there is no need to make anything public or grant access to anything. Copy the Markdown from the repository and paste it here.

Why does my HTML show up as text?

Raw HTML has no equivalent in the typesetting engine, so tags are shown rather than interpreted. Most README HTML is layout: replace a centred logo block with a plain image line and a <details> block with a heading.

Guides and use cases

ChatGPT to PDF

save a ChatGPT answer as a clean PDF with its tables, code and formulas

DeepSeek to PDF

export DeepSeek answers, formulas included, as a PDF

Claude to PDF

turn Claude answers and Markdown artifacts, Mermaid diagrams included, into a PDF

Gemini to PDF

save Google Gemini responses as a typeset PDF

Mermaid to PDF

diagrams that render as vectors, with selectable text, in the PDF

CLAUDE.md to PDF

agent instruction files and Claude Code plans as a readable PDF

Print Markdown

print a .md file with proper page breaks, diagrams and fonts