Markdown Table Compatibility Guide
Understand renderer differences, escaping, multiline cells and features Markdown tables cannot preserve.
Markdown tables are widely supported extensions, not a feature of the smallest CommonMark language.
Know the baseline
CommonMark defines portable core syntax, while table pipes and alignment markers are commonly supplied by platform extensions. A table that works on one service may render as ordinary text elsewhere.
Test the exact renderer
Preview in the application that will publish the document. Do not rely on a different editor's preview when the destination has its own parser or security filters.
Escape separators
A vertical bar inside a cell may be interpreted as a new column. Escaping rules can interact with inline code and backslashes, so include these values in the acceptance sample.
Handle line breaks
Multiline cells are not uniformly portable. Consider replacing line breaks with deliberate HTML supported by the destination, or restructure the data into separate rows or prose.
Reject false fidelity
Merged cells, formulas, colours, multiple header tiers and interactive controls have no direct Markdown-table equivalent. Document or redesign those features instead of claiming a lossless conversion.
Portable fallback
For critical information, provide an accessible prose or list alternative and retain the structured source. Formatting convenience should not be the only copy of the data.