thoughtasylumTOOLBOX Preview Guides Use offline Automate Feedback

Tools › Text

Markdown Table

Turn a Markdown table, CSV, rows pasted from a spreadsheet, or a JSON array into a Markdown table, with the columns lined up and any alignment kept.

About this tool What it's for, how to use it and an example

What it's for

Make a Markdown table without lining up pipes by hand. Paste CSV, spreadsheet cells or JSON, or tidy an existing Markdown table so its columns line up.

For example, when you want a table from a spreadsheet in a README, a GitHub issue or your notes, or someone’s hand-made Markdown table has gone ragged.

It can also draw a plain-text table with box characters, for a table in a code comment, a config file or a terminal where Markdown isn’t shown.

How to use it

Paste a Markdown table, CSV, rows copied from a spreadsheet, or JSON, and choose Make table. The first row becomes the header; with JSON, an array of objects, their keys become the header (nested values are written as JSON). Tick Line up the columns to pad the cells so the table reads well as plain text too. An existing Markdown table keeps its column alignment (left, centre or right).

Choose an Output to change the style. Markdown is the default. The plain-text styles are ASCII (+, - and |), a box with single lines, one with rounded corners, one with double lines, and rule under the header only. Each column is as wide as its widest cell, and wide characters such as Chinese, Japanese and emoji take two columns, so the box stays straight. Copy copies the table.

Example

Paste this and choose Make table:

Fruit,Price,Stock
Apples,£1.20,40
Blueberries,£2.50,12

With Line up the columns ticked, the result is:

| Fruit       | Price | Stock |
| ----------- | ----- | ----- |
| Apples      | £1.20 | 40    |
| Blueberries | £2.50 | 12    |

Good to know

Markdown tables can’t merge cells or hold line breaks inside a cell. Pipes (|) inside a cell need escaping as \| in most Markdown renderers.

The plain-text styles turn a line break inside a cell into a space. Their widths assume that a wide character takes two columns, which some terminals and editors don’t follow for every emoji, so check a table where it will be used.

Guides: Cleaning up text copied from a PDF, email or web page · Documenting a project's files, tables and links · Turning notes or a Word document into a polished PDF report

A Markdown table keeps its column alignment. The first row becomes the header. The plain-text styles are for code comments and terminals: they line up by displayed width, so CJK and emoji count as two columns.

Built with The third-party code and data this tool uses, and their licences

This tool uses no third-party code or data of its own: its code was written for this site.

Every page also uses Montserrat (SIL Open Font License 1.1).
Everything the site uses is on Credits and licences.

Private: this tool runs in your browser. Nothing you type, paste or choose leaves this page.

Saved you a few minutes? Say thanks with a coffee.

Something wrong with this tool, or missing from it? Report a bug or suggest a feature.

↑ ↓ move↵ openesc close