HTML to Markdown Converter
Convert HTML to clean Markdown, including tables, task lists, code blocks with language and strikethrough.
Tool guide
What this tool does
HTML to Markdown Converter rewrites web page markup as readable Markdown. It handles headings, emphasis, links, images, nested lists and blockquotes, converts tables, strikethrough and checkbox lists to GitHub Flavored Markdown, keeps code block languages, drops scripts and navigation, and lets you choose every style detail.
Moving content out of a CMS, a help centre or an old website into a docs repository or a note-taking app usually means turning HTML into Markdown. Doing it by hand is slow, and naive tools leave behind inline styles, empty spans and broken tables, or flatten code samples so indentation is lost.
This converter is built on turndown, which walks the HTML document tree and emits Markdown for each element, escaping characters that would otherwise be read as formatting. On top of it, the tool adds GitHub Flavored Markdown rules: <table> becomes a pipe table with alignment taken from the align attribute or text-align style, <del> and <s> become ~~strikethrough~~, and checkbox list items become task list entries. Fenced code blocks keep the language from class="language-…". Scripts, styles, forms, navigation and inline SVG are removed. Everything runs in your browser.
How to use HTML to Markdown Converter
- Paste HTML into the input, open an .html file, or click Sample.
- Choose Headings style, Bullet character, Italic and Bold markers to match your project’s conventions.
- Pick Code blocks as fenced or indented, and the Fence characters.
- Select Links: inline [text](url) or reference style with numbered links collected at the end.
- Keep GitHub tables, strikethrough and task lists on unless your target renderer only supports basic Markdown.
- Copy the Markdown or download document.md.
Tips for better results
- Copy the article container from your browser’s developer tools (right-click, Copy outerHTML) rather than the whole page to avoid menus and footers.
- Reference-style links make long technical documents easier to read in source form.
- If a code sample contains triple backticks, the fence is automatically lengthened so the block is not cut short.
- Tables with merged cells (colspan or rowspan) cannot be expressed in Markdown; check them after conversion.
Common use cases
- Migrating a blog or knowledge base from a CMS to a static site generator.
- Saving web articles as Markdown notes.
- Converting rich-text editor output into Markdown for a Git-based docs repository.
- Turning HTML email or newsletter archives into plain, readable text.
Common mistakes to avoid
- Converting a full page and keeping cookie banners and footers; select the main content first.
- Expecting layout to survive. Markdown has no columns, colours or font sizes, so purely visual styling is dropped.
- Disabling GFM output and then losing every table, which basic Markdown cannot represent.
Frequently asked questions
Are HTML tables converted?
Yes. Simple tables become GitHub pipe tables with a header row and alignment markers. Pipes inside cells are escaped, and line breaks inside a cell are joined with spaces because Markdown tables are single-line.
What happens to scripts and styles?
With Drop scripts, styles, forms and navigation on, those elements are removed completely, including their content. Otherwise their text may appear in the output.
Why are some characters escaped with a backslash?
Characters such as *, _ and # at the start of a line would be read as formatting. turndown escapes them so the Markdown renders exactly the same text as the original HTML.
Does it work on pasted rich text?
Paste the HTML source rather than the rendered text. Many editors offer a source view, and browser developer tools can copy an element’s outer HTML.
Feedback & suggestions
Help us improve HTML to Markdown Converter. We read every message.