HTML TABLE TO
MARKDOWN
Convert HTML table markup to clean Markdown table syntax instantly. Perfect for documentation and README files.
HTML TABLE TO MARKDOWN
ACCEPTED INPUT
- Paste any <table> HTML.
- Works with tables copied from web pages, email clients, or HTML editors.
- The converter strips inline styles and class attributes.
OUTPUT FORMAT
- Produces a pipe-delimited markdown table.
- <th> elements become headers; <td> elements become data rows.
TIPS
- Tables with merged cells (colspan, rowspan) are not fully supported -- split them manually first.
- Nested tables are extracted as flat text.
WHEN TO USE THIS TOOL
MIGRATING FROM A CMS
You are moving blog posts or documentation from WordPress, Confluence, or a similar platform to a markdown-based static site. The export gives you HTML files full of <table> tags that your new site cannot render. Paste each table here, copy the pipe syntax, and drop it into your MDX or markdown file.
WRITING A GITHUB README
You found a comparison table on a website showing API rate limits, feature tiers, or benchmark results. You want to include it in your README. Instead of retyping every cell and counting pipe characters, you copy the page source, paste the HTML here, and get a clean markdown table in under five seconds.
DOCUMENTING AN API
Your Swagger or Postman export produced an HTML report with parameter tables. You need those tables in a markdown-based doc site like Docusaurus or MkDocs. This converter handles the translation so you do not have to hand-edit pipe syntax for a 20-row table.
HOW IT WORKS
PARSING THE HTML
The tool parses your input and locates the outermost <table> element. It then walks each <tr> row and reads the <th> or <td> cells in order. Inline styles, class names, and HTML attributes are discarded so only the text content survives.
BUILDING THE PIPE TABLE
The first row of <th> cells becomes the header row. The converter then inserts the mandatory separator line (| --- | --- |) required by the CommonMark spec. Each subsequent row of <td> cells is rendered as a data row with pipe delimiters on both sides.
LIMITATIONS
Markdown tables do not support merged cells. If your HTML uses colspan or rowspan, you will need to split those cells manually before converting. Nested tables are flattened to their text content rather than preserved as sub-tables.
FREQUENTLY ASKED QUESTIONS
DO I NEED TO INCLUDE THE FULL HTML PAGE?
No. You only need the <table> element and its contents. You can copy just the table tag from your source code or browser devtools, paste it in, and the converter will handle it. Pasting a full HTML document also works, but only the first table will be extracted.
DOES THE MARKDOWN TABLE WORK IN GITHUB?
Yes. GitHub Flavored Markdown (GFM) supports pipe tables, and the output from this tool follows that format exactly. The header row, separator line, and data rows will render as a formatted table in any GitHub README, PR description, or issue.
WHAT HAPPENS TO LINKS AND FORMATTING INSIDE CELLS?
Basic inline formatting such as bold (<strong>) and italic (<em>) is preserved as markdown syntax where possible. Anchor tags (<a href>) are converted to markdown link syntax. Complex nested HTML inside a cell is simplified to plain text.
CAN I CONVERT MULTIPLE TABLES AT ONCE?
The tool processes one table at a time. If you have an HTML file with several tables, copy each one separately and run the conversion for each. If you need to convert large batches of tables, consider using a command-line tool like pandoc with a script.
RELATED TOOLS
MARKDOWN TABLE GENERATOR
Build a markdown table from scratch using a grid editor. Useful when you do not have existing HTML to convert.
CSV TO MARKDOWN TABLE
Convert comma-separated data exported from Excel or Google Sheets directly into a markdown pipe table.
MARKDOWN TO HTML
Go the other direction: convert a markdown file to HTML for embedding in a webpage or email template.