Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Table Rules

Rules for formatting Markdown tables.

Rules in This Category

RuleDescriptionAuto-fix
MD055Table pipe style consistencyYes
MD056Table column countYes
MD058Tables surrounded by blank linesYes

Overview

Table rules ensure consistent and valid table formatting. Properly formatted tables render correctly across all Markdown parsers.

Common Issues

  • Inconsistent pipe style (leading/trailing pipes)
  • Rows with different numbers of columns
  • Tables not separated from surrounding content

Best Practices

  • Use leading and trailing pipes for clarity
  • Ensure all rows have the same number of columns
  • Surround tables with blank lines
  • Align columns for readable source (optional)

Example Table


| Header 1 | Header 2 | Header 3 |
|----------|----------|----------|
| Cell 1   | Cell 2   | Cell 3   |
| Cell 4   | Cell 5   | Cell 6   |