MD to PDF

A Markdown résumé,
as a clean PDF

Write the content in Markdown and let the layout be someone else's problem. The result is a PDF with a real text layer — which is exactly what an applicant tracking system needs in order to read it.

document.md
Source
77 lines · 308 wordsLn 1, Col 1

Why a résumé is a good fit for Markdown

A résumé is mostly a short list of headings, dates and bullets, and almost all the time spent on one in a word processor goes into fighting the layout rather than improving the content. In Markdown the structure is unambiguous, the file is small enough to keep in version control, and tailoring it for a specific role is a text edit rather than a formatting exercise.

Making it survive an applicant tracking system

Most large employers parse your PDF before a person sees it, and most parsing failures come down to the file not containing readable text in a sensible order. A few choices matter more than the rest.

  • The text must be real text, not a picture of text — exporting a design tool's canvas as an image is the most common way a résumé becomes unreadable, and does not happen here
  • Use headings for sections and bullets for achievements, so the reading order matches how a human would read it
  • Avoid multi-column layouts and avoid tables used purely for positioning; parsers read them in an order you did not intend
  • Keep contact details in the body rather than in a header or footer, which some parsers skip
  • Links to LinkedIn or a portfolio stay clickable, so write them as [text](url) rather than pasting a bare URL
  • Fonts are embedded, so the document looks the same on the reviewer's machine as it does on yours

Fitting it onto one page

The style panel is the fastest way to gain or lose a page without cutting content you wanted to keep. Reduce the margins, drop the body size by a point, and choose a more compact typeface — Inter and Source Serif set tighter than Merriweather at the same size. Turn page numbers off, since a one-page résumé does not need one, and leave the title page off so your name stays at the top of the first page.

A structure that parses cleanly

Name as the top-level heading, contact details on the line beneath, then one second-level heading per section — Experience, Education, Skills. Under each role, a third-level heading with the job title and dates, then bullets for what you actually did. Nothing more elaborate is needed, and anything more elaborate is where parsers start guessing.

Common questions

Is a PDF from Markdown ATS-friendly?

Yes, provided the PDF contains real text rather than an image. This converter produces embedded, selectable text with a sensible reading order, which is what parsers need.

How do I get my résumé onto one page?

Narrow the margins, drop the body size a point, and pick a more compact typeface in the style panel. The preview shows the page count as you change them, so you can stop as soon as it fits.

Will my LinkedIn and GitHub links be clickable?

Yes, if you write them as Markdown links. They stay live in the PDF, so a reviewer can follow them straight from the file.