How to Convert Delimited Text to a Markdown Table

What this tool does

Turn delimited text into a Markdown table when you already have rows and columns in plain text but need Markdown formatting. The tool supports a configurable delimiter, header handling, and left, center, or right alignment, so it can fit simple notes, pasted data, and developer documentation workflows.

The default delimiter is a comma. The first row is used as the header unless header handling is turned off, in which case generic column labels are created. Left alignment is selected by default.

How to convert delimited text

1. Prepare at least two nonblank lines of delimited text. Put one record on each line and use the same delimiter between cells where possible. For example:

text Product,Status API,Ready Docs,In progress

1. Paste the text into the input area. Leading and trailing whitespace around the whole input and individual cells is removed, and blank lines are ignored.

2. Choose the delimiter that separates your cells. Comma is selected by default, but change it when your text uses another separator, such as a tab or vertical bar.

3. Decide how the first row should be handled. Leave header handling enabled when the first row contains column names. Turn it off when the first row is ordinary data; the tool then supplies generic column labels.

4. Select an alignment: left, center, or right. Left is the default. Then run the conversion to build the Markdown table.

5. Review the output before copying it. If one row has fewer cells than the widest row, empty cells are added so the table can be built with a consistent width.

How to read and check the result

A successful result is Markdown table text with a header treatment determined by your header setting, followed by rows formed from the nonblank input lines. The selected alignment controls the table’s column alignment. If an alignment value outside the supported choices is supplied, the result falls back to left alignment.

Check the column boundaries first. Unexpected extra columns usually mean the selected delimiter also appears inside your data, while missing-looking values can result from rows that contain fewer cells than the widest row. The conversion requires at least two nonblank input lines, so a single populated line is not enough for a successful result.

Worked example

A documentation writer has two product-status rows in comma-delimited text and wants Markdown table text for a project page.

Keep the comma delimiter and header handling enabled, select left alignment, and convert the prepared text.

The output has a header row for Product and Status, a Markdown separator row, and two data rows: API with Ready and Docs with In progress. With left alignment selected, the columns use left alignment.

Limitations

• The input is split into cells using the supplied delimiter on each nonblank line. Rows shorter than the widest row receive empty cells, so review data that contains the delimiter or uneven row lengths.

Common errors

• If the output has too many columns, the selected delimiter may not match the separator in your input. Choose the character used between cells and convert the text again.

FAQ

Can I convert a one-line input?

Yes, when the text contains at least two nonblank lines. A single populated line does not meet the minimum input requirement.

Can I use a delimiter other than a comma?

Yes. Comma is the default, but you can select another delimiter that matches the separator between cells in your text.

What happens if my first row is not a header?

When header handling is disabled, the first row is not treated as the header and generic column labels are generated.