How to make a Markdown resume ATS-friendly

What an ATS actually reads

An applicant tracking system converts your PDF into text, then tries to classify it: contact details, work history, education, skills. It does not “see” design. It sees reading order, text layers and labels.

That is why a PDF exported from a browser print engine is usually safer than a screenshot-style export: the letters remain selectable text, links remain links, and headings keep their hierarchy.

Structure beats decoration

Use the section names a parser expects: Summary, Experience, Education, Skills. Creative labels like “My Journey” may look nice, but they give the parser nothing to attach your dates to.

• Keep one column. Multi-column layouts scramble reading order when converted to text.
• Put the job title and company on the same line as the date range.
• Use a consistent date format such as 2021 — Present or Jan 2021 – Present.
• Spell out acronyms once: “Search Engine Optimization (SEO)”.
• Avoid text inside images, icons or decorative shapes when it carries meaning.

Mirror the job description honestly

Keyword matching is mostly literal. If the posting says “PostgreSQL” and you wrote “Postgres”, include both forms once. Read the requirements list, highlight the terms you genuinely have, and weave them into bullets instead of stacking a keyword wall.

Never stuff Modern systems and recruiters both notice keyword lists that do not match the narrative. A term you cannot discuss in an interview costs more than it earns.

Dates, titles and file names

• Use years or three-letter months, never seasons or quarters alone.
• Explain gaps briefly in one line rather than hiding them with fake dates.
• Name the file first-last-resume.pdf; “resume-final-v7.pdf” reads as unfinished.
• Set the PDF title metadata by exporting from a page titled with your name.

Export a PDF with a real text layer

Open the print dialog and choose “Save as PDF”. Do not use “Print to image” or a canvas screenshot tool. After exporting, open the PDF and try to select a bullet — if you can highlight individual words, most parsers can read them too.

Turn on background graphics so accent rules and chips survive, but keep the body text dark on white. ATS parsers do not care about color, yet human readers still do.

A 60-second ATS checklist

• Name, email and phone appear as plain text at the top.
• Every role has a title, organization and date range.
• Section headings use the standard four names.
• No tables, columns, text boxes or embedded screenshots.
• The PDF text can be selected and copied.
• The file name includes your name and the word “resume”.
• The most important keywords appear in the top third of page one.