What comes across, and what doesn’t
The whole list, so nothing in the output comes as a surprise.
- Comes across: the words, their order, and the page they were on.
- Comes across: headings, if you turn the guess on. It compares each line against the median body size and writes one hash for a line clearly larger, two hashes for a moderate step up. Two levels, no more.
- Doesn’t come across: bold, italic and inline emphasis. The output has no way to know which words were emphasized, and inventing emphasis from font weight produces a file that looks structured and isn’t.
- Doesn’t come across: lists, tables, links, footnotes, and captions as captions. A table arrives as its rows in reading order, which is often enough to rebuild by hand and never enough to do automatically.
- Doesn’t come across: images and drawings. Markdown can reference a file, but a PDF conversion has no image to point at.
How the heading guess actually decides
Every line carries a font size. The tool takes the median across the page as the body size, then compares each line against it: a large step up becomes a level-one heading, and a smaller step becomes level two.
It’s a guess by construction, so it will promote an oversized caption now and then. The result panel reports how many lines it promoted, which is the number to check against the document in front of you.
Page boundaries are kept on purpose
The Markdown export writes the file name as a title, then one section per page, then that page’s lines. A heading per page sounds like noise until you need to cite something: a page number you can see in the file is worth the extra line.
Turn it off for documents where pages are an artifact of printing. A web page someone exported to PDF has no page structure worth respecting.
Repeated headers and footers
A running header on every page becomes a paragraph on every page. The filter drops a line when it repeats on at least 60% of pages, judging only the first three and last three lines of each page, the bands where running heads live.
Because it’s a threshold rather than a rule, it will occasionally keep a header, or drop a line that happened to repeat. The result panel says what it removed, so the check is a glance rather than a reading.
The output is a draft, and that’s the point
The preview is an editable text area. Fix the two lines that came out wrong, then copy or download. A conversion that claims to need no checking is either simplifying your document or guessing without saying so.
