CleanorTools
Markdown

Markdown Table Formatter

Details

How to use Markdown Table Formatter

What the tool does, how to run it, and what to expect from the result.

How to format a Markdown table

To format a Markdown table, paste one existing table into the input box. The formatter parses the rows, pads each column so the pipes line up, and normalizes the dashed separator row beneath the header, producing source that is far easier to read and edit by hand.

The tool only changes spacing and alignment, never the words inside your cells. A rendered preview confirms the table still displays exactly as before, so you can trust that formatting did not alter your data. Input that does not parse as a table is rejected rather than mangled.

All formatting runs locally in your browser. Your table is never uploaded to a server, so you can safely tidy tables in private docs or internal notes.

  • Paste one existing Markdown table
  • Columns are padded and aligned automatically
  • The separator row is normalized
  • Copy or download the cleaner Markdown

Formatter or generator: which do you need

People searching for a table formatter already have a Markdown table and just need to clean it up so the source is aligned and readable. That is exactly what this page does, one table at a time.

People starting from raw rows, copied from a spreadsheet or CSV, want to build a new table from scratch instead. For that, the Markdown Table Generator is the right tool, since it assembles a fresh table with headers and per-column alignment.

Keeping the two intents on separate pages makes both faster: this formatter stays focused on cleanup, while the generator focuses on construction.

Tips

Getting a better result out of Markdown Table Formatter

Specific settings and thresholds, not general advice.

  • Every non-empty line of the input has to contain a pipe. Paste a table with a paragraph above it and the whole input is rejected, not partially formatted, so select just the table before you copy.
  • The header row and the separator row must have the same number of cells, and the header needs at least two columns. That check is where nearly every 'the header and separator row do not line up' message comes from, and it is usually a missing pipe at one end of the separator.
  • Alignment is read from your existing separator row (:---: means center, ---: means right, anything else is left) and then rewritten in normalized form, so a hand-typed :-: comes back as :---: and the meaning is preserved.
  • Cells are padded to the widest content in each column, with a minimum width of 3 characters. That padding is purely cosmetic, since every Markdown renderer ignores it, but it is what makes the table readable in a source diff.
  • Body rows are not validated against the header width. A row with an extra cell is padded out to the widest row instead of being rejected, so check the rendered preview before pasting the result back into a docs file.
Limits

What Markdown Table Formatter does not do

The honest boundary, so you do not lose time finding it yourself.

  • One table per run, and no surrounding prose is allowed in the input.
  • It does not escape pipe characters inside cell content.
  • It cannot add, remove, sort, or reorder columns and rows.
  • It never edits cell content, so long cells are not wrapped or truncated.
Reference

Terms used on this page

Short, plain-language definitions for the formats and settings above.

Files & formatsMarkdownMarkdown is a lightweight, plain-text formatting syntax that turns simple symbols into formatted text — `#` for headings, `*` for emphasis, and `-` for lists. It stays readable as raw text and converts cleanly to HTML.General
At a glance

Who Markdown Table Formatter is for

A quick way to understand who this helps, what it solves, and where it connects next.

Best fit

Docs writers, developers, and maintainers cleaning existing README or docs tables before shipping them.

Ideal for

Fixing messy Markdown tables quickly when the content is already there but the formatting is painful to read.

FAQ

Common questions

Short answers for the questions people usually have before trying a utility like this.

Is the Markdown Table Formatter free?

Yes. This tool is completely free to use, with no sign-up required.

Does it upload my table to a server?

No. All formatting happens locally in your browser, so your table never leaves your device.

Will it preserve my table content?

Yes. The formatter only aligns columns and normalizes the separator row; it never rewrites or reorders the content of your cells.

Does it reformat non-table content too?

No. This page handles one Markdown table at a time and will reject input that does not parse as a table.

Can I preview the formatted table?

Yes. A rendered preview shows the table before you copy or download the cleaner Markdown.

Why was my input rejected when the table itself is fine?

The formatter requires that every non-empty line contains a pipe, which means a heading or a sentence above the table causes the whole input to be rejected. Copy only the table lines, including the header and the separator row, and paste those on their own.

What does 'the table header and separator row do not line up' mean?

The header row and the separator row parsed to a different number of cells. The usual cause is a missing pipe at the start or end of one of the two rows, or a separator row with one fewer dash group than the header has columns. Count the cells in both rows and make them match.

Does the extra padding it adds change how the table renders?

No. Markdown renderers strip whitespace inside cells, so the aligned source and a table crammed against its pipes render identically. The padding exists for humans reading the raw file and for reviewers reading a diff.

Will it keep my column alignment?

Yes. It reads the alignment out of your existing separator row and writes it back in normalized form. Left stays left, :---: stays center, ---: stays right. It does not change any alignment you chose.

Can it fix a table with a cell that contains a pipe character?

No, and neither can any Markdown renderer. A raw pipe inside a cell is read as a column separator. Escape it with a backslash in the source, then run the formatter on the corrected table.

Is the table content uploaded?

No. Parsing, formatting, and the preview all happen in the browser, so tables containing internal metrics or customer names stay local.

Recommendations

You Might Also Like

Nearby tools from the catalog that fit the same job or workflow.

CLEAN
UtilityMarkdown

Markdown Cleaner

Clean Markdown spacing

Clean Markdown spacing, heading gaps, list spacing, fence spacing, and trailing whitespace locally.

TABLE
UtilityMarkdown

Markdown Table Generator

Generate Markdown tables

Generate Markdown tables from comma, pipe, or tab-separated rows with alignment controls.

ALT
UtilitySEO

Alt Text Cleaner

Clean alt text

Clean noisy alt text locally without turning it into an AI writing tool.

HTML
UtilityHTML

HTML Formatter

Beautify HTML markup

Beautify pasted HTML locally and export cleaner, easier-to-read markup.

H2MD
UtilityMarkdown

HTML to Markdown

Convert HTML to Markdown

Convert practical HTML snippets into Markdown locally and preview the result.

FMT
UtilityData

JSON Formatter

Format JSON cleanly

Pretty-print pasted JSON locally with stable indentation and export-ready output.

Cleanor app

Do it all on your device

Cleanor puts these tools in one app: compress and convert images, video, and audio, work with PDFs, and scan text right on your device. Plus free up storage and clear inbox clutter with Email Cleaner. Start with a free trial.

  • iPhone
  • Android
  • Macsoon
  • Windowssoon
Get it on the App StoreGet it on Google PlayAll platforms & pricing