FreeMD2PDF.com
  • Runs locally
  • no upload
  • no signup
  • no watermark
  • works offline
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’s security policy blocks images from other websites, 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 and :rocket: shortcodes stay as text; actual emoji characters are embedded with a colour emoji font.

    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 the page’s security policy blocks images from other servers.

    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

    Generating…