What Markdown is
Markdown is plain text with simple marks for structure: # for headings, - for bullet points, ** for bold text and | for tables. It is used for README files on GitHub, documentation sites, note apps like Obsidian and Notion, blogs, and as clean input for AI assistants.
What happens when you convert
The text of each page is read and rebuilt into paragraphs. Very large text becomes a # heading and large text a ## heading, bullet characters become Markdown lists, short bold lines become bold, and lines with several clear columns become Markdown tables. Pages are separated by a --- line. Special characters are escaped so they do not accidentally change the formatting.
Which PDFs convert best
Reports, manuals, notes and articles with clear headings and lists give clean Markdown. Pictures, page layout and colours are not included. Scanned PDFs contain no text — run OCR PDF first.
Common problems and how to fix them
A table came out as plain lines: its columns were not clearly spaced; add the | separators yourself. Headings have the wrong level: change # and ## as needed. Repeated page headers or page numbers appear: delete them with your editor's find-and-replace.
Good habits
Preview the .md file in a Markdown editor, fix structure once before reusing it, and keep the original PDF for reference.