Code and data guides

Repair a Markdown table with an uneven header and rows

·

Repair a Markdown table when a README shows source pipes or hides a value at the end of a row. Compare the rendered cells before replacing the table in a shared document.

Markdown Table Repair

Recover the third column in the rollout example

Load the rollout example and choose Repair tables. Its header names two fields and its original delimiter has one cell. The North data row has a third value, 3/4. Expect one repaired table with three columns and three data rows.

In the preview, North keeps 3/4, Café shows A|B in a single inline code cell, and West has blank cells after its region. Region stays left-aligned. The runbook paragraph above and the reminder below are still visible.

GitHub Flavored Markdown table syntax and examples

Compare aligned and compact Markdown source

With Aligned columns, the source includes padding and wider runs of dashes. Switch to Compact spacing and repair again. Confirm that North still shows 3/4 and Café retains its code value. The change affects the saved source spacing.

Copy or download the Markdown. Name the blank header if the third column represents a distinct measure. When reviewing the saved source, expect a backslash before the pipe inside the code span and the same left-alignment colon in the first delimiter cell.

GitHub Flavored Markdown table syntax and examples

Insert a missing delimiter only for a clear table

For a pasted table with a header immediately followed by data, enclose each row in pipes and enable Insert missing separator rows. Put a blank line before prose that follows the table.

If the tool flags a neighboring line as ambiguous, add a blank line or make the intended row explicit before retrying. A GFM renderer can treat ordinary text directly below a table as a one-cell row.

GitHub Flavored Markdown table syntax and examplesGitHub documentation on organizing information with tables

Common questions

Why is my last value missing even though the table renders?

GFM ignores data cells beyond the number of header cells. Give the header and delimiter enough columns, then check the repaired value in the preview.

Do the leading and trailing pipes change the table contents?

GFM accepts many tables without edge pipes. The repair adds edge pipes consistently so the cell boundaries are easier to read in the source.

Sources

Put it into practice.

Related guides