b2KIT

HTML to Markdown Converter

Convert HTML markup into clean Markdown syntax with support for tables and lists.

How to Use HTML to Markdown Converter

  1. 1

    Paste your HTML

    Enter the HTML code you want to convert to Markdown.

  2. 2

    Convert instantly

    See the Markdown output generated automatically as you type.

  3. 3

    Copy the Markdown

    Click copy to grab the clean Markdown text.

Tested tool guide Tested browser tools Checked August 16, 2026

What HTML to Markdown Converter does, with a checked example

HTML to Markdown Converter reads pasted HTML as structured markup and rewrites recognizable elements as Markdown text: paragraphs become separated blocks, links keep their destinations, emphasis becomes Markdown delimiters, and list and table structure is represented in text form. It is intended for source conversion, not for reproducing a rendered page. The common surprise is that CSS, classes, dimensions, and interactive behavior have no general Markdown equivalent, so visual fidelity is not the result. Because the conversion runs in the browser, source pasted from private documentation is not uploaded.

Worked example

A concrete input and expected output from the current implementation.

Input

<p>Ready.</p>

Expected output

Ready.

A paragraph is a block in Markdown, so its text remains while the p tags disappear. No Markdown punctuation is needed because the paragraph contains only plain text.

How the result is produced

1

Element mapping

The converter works from element meaning rather than the browser's painted appearance. Paragraph, heading, emphasis, strong emphasis, link, blockquote, code, and list elements are mapped to their Markdown counterparts, with blank lines and indentation used to preserve block boundaries and nesting. Text content remains text; HTML-only attributes generally have nowhere to go in Markdown.

2

Lists and tables

For lists, each list item becomes a marked line, and nesting is conveyed through indentation. For supported tables, row and cell boundaries become Markdown table structure rather than tab-separated plain text. This mapping is narrower than HTML: merged cells, per-cell styling, captions, and complex block content inside a cell cannot all be represented by ordinary Markdown table syntax.

Good uses

  • Moving a short HTML documentation fragment from a content management system into a repository README maintained as Markdown.
  • Converting an HTML table and its surrounding lists into text for a GitHub issue, pull request, or wiki page.
  • Removing presentation markup from generated HTML while retaining headings, links, emphasis, code, lists, and other document structure.

Limits and checks

  • Compare nested lists carefully. Markdown renderers have different indentation expectations, so output that looks valid can flatten a sublist in the destination.
  • Inspect tables that use rowspan, colspan, captions, or multiline cell content. Basic Markdown table syntax cannot represent every HTML table relationship.
  • Resolve relative href and src values against the original page before moving the result. A copied relative path may point somewhere different from its new Markdown file.

Common questions

Can I convert the Markdown back into the original HTML?

No. HTML-to-Markdown conversion is normally lossy: multiple HTML structures can produce the same Markdown, and attributes such as class, id, style, and data values have no standard Markdown representation. Keep the original HTML if you may need its styling hooks, detailed semantics, or exact table structure later.

Will a converted table render in every Markdown viewer?

Not always. Pipe tables are an extension used by GitHub Flavored Markdown, not part of the CommonMark core specification. A destination supporting only core CommonMark may display the pipe characters as ordinary text. Preview the converted table in the exact editor, renderer, or publishing system where it will be used.

References and verification

The example and behavioral notes were checked against the browser implementation. Standards and primary references below define the relevant format, formula, or platform behavior.

Related Tools