Repair a Markdown table with an uneven header and rows
Admin ·
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.
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.
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.
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.