Markdown Table Guides by Platform
By MarkdownTables.com editorial teamUpdated
The pipe-table syntax is the same almost everywhere; what changes is what each platform renders around it. These guides cover one platform or problem each, with copyable examples and the limits you'll run into. New to tables? Start with the Markdown table syntax guide, or keep the cheatsheet open.
Tables on a specific platform
What each platform renders, what it strips, and the workarounds that hold.
GitHubGitHub Markdown Tables: How to Add a Table to a READMESyntax, alignment, badges and images in cells, code blocks, centering, wide tables, why tables can’t be sorted, and how GitHub Pages differs.GitLabGitLab Markdown Tables: Syntax, Sorting and JSON TablesGitLab’s pipe tables, sortable and filterable
json:table blocks, checkboxes in cells, and tables in merge requests.Obsidian · NotionTables in Obsidian and Notion: Formatting, Plugins and FormulasEditing pipe tables in Obsidian, escaping wikilinks, plugins and Bases, and how Notion converts Markdown tables on paste and export.VS CodeMarkdown Tables in VS Code: Preview, Format and EditPreview shortcuts, formatting with Markdown All in One or Prettier, format on save, markdownlint table rules, multi-cursor editing and sorting.Discord · Slack · TeamsHow to Make a Table in Discord, Slack and Microsoft TeamsCode-block tables for Discord and Telegram, Slack’s Block Kit table block for apps, Teams’ Insert table and Adaptive Cards, and when to send an image.Troubleshooting
When the pipes show up as plain text.
Code and publishing
Generate, render and convert tables from code and documents.
PythonPython Markdown Tables: pandas and tabulateWrite tables with pandas
to_markdown(), tabulate or plain Python, and read Markdown tables back into a DataFrame.React · Next.jsMarkdown Tables in React and Next.jsRender GFM tables with react-markdown and remark-gfm, style them with your own components, and make wide tables scroll on phones.PandocPandoc Markdown Tables: Pipe, Grid and MultilinePandoc’s four table syntaxes, captions, column widths and multi-line cells, and converting tables to PDF and Word.Copy, paste and publish
Move tables between chat apps, Office, notebooks, wikis and static sites.
Word · Excel · DocsHow to Copy a Markdown or ChatGPT Table into Word, Excel and Google DocsCopy a ChatGPT, Claude or Gemini table into Word, Excel, Google Docs or Sheets, or split pasted pipes with Text to Columns.Confluence · JiraMarkdown Tables in Confluence and Jira: Paste, Wiki Markup and Line BreaksPaste behavior,
||header|| wiki markup, line breaks, escaping, ADF and storage format.Static sitesMarkdown Tables in Hugo, Jekyll, MkDocs and DocusaurusThe parser each generator uses, classes, widths, headerless and merged tables, sorting and data-driven tables.Notebooks and reports
Tables in Jupyter, R Markdown and Quarto documents.
JupyterHow to Make a Table in a Jupyter Notebook Markdown CellPipe tables in Jupyter, alignment fixes, merged cells with HTML, math, DataFrames and nbconvert.R · QuartoR Markdown and Quarto Tables: kable, gt, Captions, Widths and Merged CellsPipe tables,
kable, kableExtra, gt, flextable, tbl-cap cross-references, widths, merging and sortable tables.