HTML to Markdown Converter
How to Convert HTML to Markdown Online
Drag & drop or click Browse. Max 100 MB.
The file is converted on our server by Pandoc, the open-source document converter. There are no options to choose.
Download your converted Markdown file. Auto-deleted within 4 hours.
Built on Pandoc
Auto-Deleted
15+ Formats
HTML to Markdown: what changes
This page rewrites a web page as Markdown: plain text with simple marks for headings, lists, emphasis and tables. That is the form AI assistants read best and the form GitHub, Obsidian, Notion and static site tools work with. The conversion is done on our server by Pandoc, the open-source document converter.
- Only the content is taken. Scripts, styles, forms and embedded frames are dropped, and layout containers are flattened. Save the page from your browser as an .html file and upload it; menus and footers of the page are part of that file and will appear in the text too.
What is kept and what is not
| In the HTML | In the Markdown file |
|---|---|
| Headings h1 to h6 | #, ##, ### … |
| Bold, italic, strikethrough | **bold**, *italic*, ~~struck~~ |
| Bulleted and numbered lists | - and 1. lists, nested by indentation |
| Links | [text](address) |
| Simple tables | Tables written with | |
| Tables with merged cells or several paragraphs in a cell | An HTML table inside the file, because Markdown tables cannot express them |
| Pictures | Left out; the picture description stays if there is one |
| Fonts, sizes, colours, page layout, headers and footers | Left out. Markdown has no way to store them |
Settings on this page
- There is nothing to set. Upload the HTML file and download the .md file, which opens in any text editor.
- Up to 100 MB. The file is deleted from our server within 4 hours.
When a different format is the better choice
- For text without any marks at all, use HTML to TXT.
- To go the other way, use MD to HTML.
Quick answers
Why convert HTML to Markdown?
To give a document to an AI assistant in a form it reads well, to move it into Obsidian, Notion or a wiki, or to keep it in a Git repository where changes can be compared line by line.
Are pictures included?
No. A .md file is text only. Pictures are left out; where a picture had a description, the description stays in the text.
Which Markdown is written?
GitHub-flavoured Markdown, which is understood by GitHub, GitLab, Obsidian, Notion import, VS Code and most other Markdown tools.
About the MD Format
Markdown is ordinary text in which a few symbols mark the structure: # starts a heading, ** surrounds bold text, a dash starts a list item, and | separates table cells. The file stays readable as it is, and programs that understand Markdown display it as a formatted document. AI assistants such as ChatGPT and Claude write their answers in Markdown, and GitHub, Obsidian, Notion, Reddit and most documentation tools use it.
John Gruber published Markdown in 2004, with Aaron Swartz, as a way to write for the web without typing HTML. GitHub later added tables, task lists and fenced code blocks (GitHub-flavoured Markdown), and CommonMark gave the format a precise specification in 2014.
Advantages
- Readable and editable in any text editor
- Tiny files that work well with version control
- Understood by AI assistants, GitHub, Obsidian and Notion
Disadvantages
- No fonts, colours or page layout
- Pictures are separate files, not part of the document
- Several dialects that differ in details