You're moving documentation from PDF to a docs site, or pulling content into an AI workflow, or just want lightweight portable text. Markdown is the right format for all of these.
Why Markdown wins for these jobs
Markdown is readable as plain text but renders as formatted HTML when needed. It's version-controllable (Git diffs cleanly), portable (every editor handles it), and AI-friendly (language models parse it well).
For documentation sites — Docusaurus, Hugo, MkDocs, Notion — Markdown is usually the input format. Converting from PDF puts you straight in.
Conversion path
Flint's convert hub outputs Markdown. Headings become `#`-prefixed lines, lists become `-` items, bold becomes `**`, links become `text`. Images come out as separate files referenced via `!alt`.
The result is clean and human-readable. Skim the first page after conversion to catch anything weird.
Tables in Markdown
Markdown's table syntax is limited — basic rows and columns, no merged cells. The converter does its best, but complex PDF tables may not survive cleanly.
For heavy tables, two options: keep them as HTML embedded in the Markdown (most Markdown processors allow HTML), or extract to Excel separately and link to the spreadsheet.
Images and asset paths
Images come out as separate files. The Markdown references them with relative paths — `!figure 1`. Drop the images folder alongside the .md when publishing.
For docs sites, this typically means putting the images in a /static folder and the .md in /docs (or wherever your site expects).
FAQ
Will tables survive?
Simple tables, yes. Complex ones with merges may lose structure. HTML inside Markdown is the fallback for complex tables.
What about footnotes?
Many Markdown flavours support footnotes. The converter outputs them when possible; check that your renderer supports the footnote syntax.
Can I use the Markdown in Notion?
Yes — Notion imports Markdown. Tables and embedded images come across. Some formatting may simplify on import.
Is GitHub-flavoured Markdown supported?
Output uses standard Markdown extensions (tables, code blocks, strikethrough) which match GitHub's flavour.
Portable, version-controllable, AI-ready. Convert your PDF to Markdown for modern docs.