A Markdown table breaks quietly. A row with one cell too many silently loses a value in GFM; a row with one too few silently gains an empty one. A pipe typed inside a code span splits the row even though it looks like content. A delimiter row with one wrong character turns the whole block back into a paragraph. None of this is reported by the renderer, and a reviewer reading the diff sees pipes that line up.
This walkthrough uses the tool's public README and checked-in example files. Run the command from a repository checkout with Node.js 22+.
Run the checked-in example
node bin/markdown-table-validator.mjs --config examples/table-policy.json examples/clean.mdRead the result
--json writes the report to stdout, and only the report, so it can be piped straight into a parser. Diagnostics always go to stderr.
Scope
It also does not fix anything. The preview is a separate file you can read, diff and copy from; nothing is written back over your documents.