How to Convert Markdown to PDF and HTML: Live Preview, Clean Output, and Exactly What Survives
A README for a client, meeting notes a manager wants as a PDF, an AI answer full of hash signs and asterisks: each is the same job, turning plain text with a little markup into something people can read. This guide shows how to convert Markdown to PDF and Markdown to HTML for free, how the markdown converter above handles tables, task lists and code, which features carry into each output, and — plainly — what to do about the few things that do not.
1. What a Markdown Converter Does, and How to Open an MD File
Markdown is plain text with a handful of conventions: a line starting with # is a heading, words wrapped in ** are bold, a line starting with a dash is a bullet. The conventions are described in the CommonMark specification, and the tables, strikethrough and checkboxes most people use today come from the GitHub Flavored Markdown spec. A converter turns them into real formatting.
It is also the answer if you searched how to open MD file attachments. If your MD file shows symbols instead of formatting, nothing is broken: you opened it in a plain text editor, which shows the raw markup. Drop the file onto the tool above (it accepts .md, .markdown and .txt) and the Live preview panel renders it immediately. Used this way, the page is a markdown viewer online; type in the left-hand box and it becomes a markdown previewer that re-renders on every keystroke.
2. How to Convert Markdown to PDF in Four Steps
Here is how to convert Markdown to PDF, or MD to PDF if you think in file extensions, with the tool above. No account and no daily limit.
- Add your Markdown. Paste it into the editor, which starts with a short sample you can overwrite, or drop a file on the panel labelled Drop a .md file or edit below. Dropping a file also fills the Title field with its name.
- Check the preview. Headings, lists, tables and code blocks appear formatted on the right. If something looks wrong here, fix it in the text now.
- Choose the output settings. Leave Convert to on PDF, pick A4 or US Letter for the page size, and set the Base font size anywhere from 8 to 16 (11 is the default). The Title becomes both the file name and the title stored in the PDF.
- Convert and download. Press Convert. A preview of the finished PDF appears with a download button, and the file is named after your title.
That also covers how to print a Markdown file: pick the paper size your printer uses, convert, and print the PDF.
3. Markdown to HTML: Styled Page or Blog Fragment
How to convert Markdown to HTML depends on where the HTML is going, and this is where most pages that call themselves a Markdown to HTML converter online stop short. There are two HTML results:
HTML page (standalone)
A complete .html file with its own stylesheet built in: readable widths, styled tables and code, and colours that follow the reader’s light or dark setting. This is Markdown to HTML with CSS in one file you can email, attach or host. The styling is fixed; custom themes are not offered.
HTML fragment
Just the body markup, with no page wrapper and no styles, shown as source and saved as fragment.html. Use it as a Markdown to HTML fragment for blog posts: paste it into a CMS and it takes on your site’s styling.
Either way, this is a full MD to HTML converter. Headings get anchor ids, so you can link straight to a section. A Markdown table to HTML becomes a proper <table> with a header row, and the column alignment you set with colons in the separator line is kept. Inline HTML passes through into both HTML outputs.
4. What Survives Into Each Output
Here is the specific list. Every output handles headings, paragraphs, bold, italic, ~~strikethrough~~, inline code, links, blockquotes, fenced and indented code blocks, horizontal rules, and nested ordered and unordered lists. Tables work everywhere, with a header row.
Markdown task list to PDF works too: - [x] and - [ ] items print with [x] and [ ] markers in front of each line, so a checklist stays readable on paper. In the HTML outputs they become real (read-only) checkboxes, ticked or empty.
The honest differences between the outputs:
- Links in the PDF are styled, not clickable. They look like links, but a reader cannot click through. The HTML outputs keep working links.
- Table cells in the PDF are plain text. Bold or a link inside a cell prints without its formatting.
- Raw HTML becomes plain text in the PDF, while the HTML outputs keep it.
- No syntax highlighting, math, diagrams, footnotes, front matter or automatic table of contents. Those extras are not rendered, so keep them out of documents you plan to convert here.
5. Images Not Showing, Emoji Turning Into Question Marks
Markdown to PDF images not showing. Images linked by a web address or a relative path () are not included, so the PDF shows the image’s alt text in brackets instead. If you are wondering how to embed image in Markdown PDF output, the answer is a data URL: the image written out as text inside the Markdown. The Base64 encoder turns an image into one, and running it through the image compressor first keeps the text shorter. Put the image on its own line and it embeds in the PDF, scaled down if it is very large. Data-URL images do not display in the two HTML outputs, so they appear in the PDF only. If your document is really a set of pictures, the image to PDF converter is the better fit.
Markdown to PDF emoji not showing? The PDF uses standard fonts that cover Western European Latin text only. Emoji, and scripts such as Urdu, Arabic, Chinese or Cyrillic, print as ?. Even the sample’s tick marks do this. Choose HTML page (standalone) instead and every character is kept; once that page is published at a web address, the save web page as PDF tool can produce a PDF from it.
Command-line Markdown to PDF not working? If a desktop converter keeps stopping on missing packages or font errors, paste the same Markdown into the editor above, check the preview and press Convert. There are no extra packages or settings files to get right first.
6. README, Obsidian, AI Answers and Phones
- README to PDF. For a GitHub README to PDF, open the file in the repository, view it raw, copy everything and paste it here. Images referenced by path need the data-URL step above.
- Obsidian notes to PDF. Obsidian notes are ordinary Markdown files, so drop one in. Wiki-style
[[links]]and plugin syntax are not standard Markdown and print as written. - ChatGPT Markdown to PDF. Use the copy button on an AI answer to get the Markdown, paste it into the editor, set a title and convert.
- Markdown to PDF A4. A4 is the default; US Letter is one click away.
- Markdown to PDF on iPhone. The page works the same on a phone: paste the text, or pick the file from the Files app, then convert and save the PDF.
The converter makes one clean PDF at a time. For finishing touches, hand the result to the PDF page numbers tool, the PDF watermark tool, the bookmarks editor or the PDF password protector. Converting several files? Do them one by one, then join them with the PDF merger.
7. Why Use the Cortexis Markdown Converter
Plenty of sites offer a Markdown to PDF converter online free. Here is what you get.
Genuinely free, no account
No sign-up, no email, no watermark and no files-per-day counter. The tool on this page is the whole product.
Three outputs from one editor
A PDF, a styled standalone HTML page and a paste-ready HTML fragment, all from the same text and the same live preview.
Your notes stay private
Files are never stored on our servers and nothing is retained once you are done.
Nothing is used for training
Your documents are never used to train anything. Internal docs and drafts stay yours.
Tables and checklists that work
Pipe tables with header rows and alignment, nested lists and ticked or empty task boxes all carry into the output.
Limits stated up front
Emoji, remote images and PDF links are explained on this page with a workaround for each, so nothing surprises you after the download.
It is one of a wider set of free document tools built on the same terms, so the convert MD to PDF privately promise holds for the finishing tools too.
8. Frequently Asked Questions (FAQ)
How do I convert Markdown to PDF for free?
Paste your Markdown or drop a .md file into the tool at the top of this page, check the live preview, choose A4 or US Letter and press Convert. The PDF downloads under the title you set.
Markdown to PDF images not showing: how do I fix it?
Images linked by a web address or file path are not included, so the PDF shows their alt text in brackets. To embed one, convert the image to a data URL with the Base64 encoder and place it on its own line in the Markdown. Data-URL images embed in the PDF output only.
Why do emoji show as question marks in the PDF?
The PDF uses standard fonts that cover Western European Latin characters, so emoji and scripts such as Urdu, Arabic, Chinese and Cyrillic print as a question mark. The standalone HTML page keeps every character. If you need a PDF of that text, publish the HTML page and use the save web page as PDF tool.
Can I convert Markdown to Word?
Not directly. Convert your Markdown to PDF here, then open the result in the PDF to Word converter to get an editable document.
What is the difference between the HTML page and the HTML fragment?
The HTML page is a complete file with its own stylesheet, including light and dark colours, ready to open or share on its own. The fragment is only the body markup with no styles, meant for pasting into a blog editor or site template that already has its own design.
Are links clickable in the PDF?
Links are coloured and underlined in the PDF but are not clickable. Share the standalone HTML page when readers need to follow links.
Can I convert a PDF back to Markdown?
This tool only goes from Markdown to PDF or HTML. To get the text out of a PDF, use the PDF to text and HTML converter, or the PDF OCR tool if the pages are scans. HTML back to Markdown is not offered.
How do I turn Obsidian notes to PDF?
Obsidian notes are plain Markdown files, so drop the .md file onto the tool, set a title and convert. Wiki-style [[links]] and plugin syntax are not standard Markdown and print exactly as written, so tidy them first if they matter.
How do I convert a ChatGPT Markdown answer to PDF?
Use the copy button under the answer to get it as Markdown, paste it into the editor and press Convert. Headings, lists, tables and code blocks keep their formatting; emoji in the answer print as a question mark in the PDF.
Does Markdown to PDF on iPhone work?
Yes. Open this page in Safari, paste your text or pick the .md file from the Files app, then convert and save the PDF to Files or share it straight on.
Can I convert MD to PDF privately?
Yes. Your files are never stored on our servers and nothing is retained once you finish. They are never used for training either, so internal docs and private notes stay yours.
PDF ready? Turn it into an editable file with the PDF to Word converter, pull the text back out with the PDF to text converter, or turn the same Markdown into an EPUB with the ebook converter, or check length with the word counter. To build pages like these yourself, try our free full-stack web development course.