Obsidian Markdown Table: Create, Edit and Format Tables
November 11, 2026 · 10 min read
Obsidian Markdown Table: Create, Edit, and Format Tables
An Obsidian Markdown table is a plain pipe table that Obsidian lets you edit like a spreadsheet. You insert one from the command palette, then right-click it in Live Preview to add, move or sort rows. This guide covers the Obsidian-only parts: escaped pipes for links, line breaks, merged cells, Advanced Tables formulas and clean export.
How an Obsidian Markdown Table Is Written
Under the editor, every table is text. Pipes separate the columns, and a row of hyphens under the first line marks it as the header. Obsidian's advanced syntax help says that row must contain at least two hyphens, and its examples use two per column. The outer pipes are optional.
| Book | Author | Pages |
| :-- | :-- | --: |
| Dune | Frank Herbert | 412 |
| Emma | Jane Austen | 474 |
Obsidian renders a three-column table with a header row. The colons in the second line set left, left and right alignment. For the full syntax, including formatting inside cells and tables without headers, see our Markdown table guide. The rest of this post sticks to what's different in Obsidian.
How Do You Insert a Table in Obsidian?
There are three ways to start one, and each leaves ordinary Markdown in the file.
- Command palette. Press Ctrl+P (Cmd+P on a Mac), type Insert Table, and press Enter.
- Right-click menu. Right-click in the note and choose Insert, then Table.
- By hand. Type the pipes and hyphens yourself, which is quickest in Source mode.
The first two drop in an empty skeleton: two columns, a header row and one body row.
| | |
| --- | --- |
| | |
You see a small empty grid in Live Preview, ready for headings. If your data already lives in a spreadsheet, the community plugin Excel to Markdown Table converts it on paste. Its README says Ctrl+V (Cmd+V) handles two or more columns, and Ctrl+Alt+V (Cmd+Alt+V) handles a single column too. For a table you want to build outside a vault, the Markdown table generator gives you a grid and outputs a GFM table to paste in.
Editing Rows and Columns With the Built-in Table Editor
Obsidian 1.5, released to everyone in December 2023, added a proper table editor. Its release notes say tables became easier to create, sort, reorder, copy and paste, and that they're still saved as plain Markdown.
In Live Preview, it works like this:
- Right-click a cell to add or delete rows and columns, move them, or sort by that column.
- Select whole rows or columns, then copy and paste them.
- Run the same table actions from the command palette, or assign them hotkeys in Settings.
All of this rewrites the pipes in your file for you. Switch to Source mode and you'll see ordinary Markdown again. If the three editing modes are new to you, our Obsidian Markdown editor review explains what each one shows.
Escaping Pipes for Wikilink Aliases and Image Sizes
This is the Obsidian table problem most people hit first. A wikilink alias and an image width both use a pipe, and inside a table a pipe means "new column". Obsidian's help says to put a backslash before that pipe.
| Topic | Reference | Preview |
| -- | -- | -- |
| Syntax | [[Basic formatting syntax\|Markdown syntax]] | ![[Engelbart.jpg\|200]] |
Obsidian shows a link labelled Markdown syntax and an embedded image 200 pixels wide. Leave out the backslashes and the parser splits each link at the pipe, so the cells shift and both the link and the embed break. The same \| also gives you a literal pipe character in an ordinary cell, such as A \| B.
How Do You Add a Line Break in an Obsidian Table Cell?
Each row has to stay on one line of Markdown, so Obsidian needs an HTML <br> tag for a line break in a cell. Obsidian renders sanitized HTML in notes, and a <br> inside a table cell becomes a line break.
| Day | Plan |
| -- | -- |
| Monday | Gym<br>Write report |
The Plan cell shows Gym and Write report on two lines. That's as far as cells go, though. A cell holds inline content only, so headings, bullet lists and task checkboxes don't render inside one. Fake a list with <br> between items, or keep the list below the table.
You can test the portable parts here. The demo uses alignment colons, an escaped pipe and a <br>. It avoids wikilinks, which only Obsidian understands.
The escaped pipe shows as a plain | in the Weekly review row, and the Reading list cell spans two lines. Our editor's preview doesn't render [[wikilinks]] or Obsidian embeds, so it shows those as plain text.
Is Advanced Tables Still Worth Installing?
Advanced Tables was the standard fix before the built-in editor arrived. Its README lists these hotkeys while your cursor is in a table:
| Hotkey | What it does |
|---|---|
| Tab | Next cell |
| Shift+Tab | Previous cell |
| Enter | Next row |
| Ctrl+Shift+D | Open the table controls sidebar |
It also auto-formats the table, padding the cells so the pipes line up in Source mode. The plugin can sort rows by the column your cursor is in, export a table to CSV, and run formulas. On mobile, Tab and Enter don't navigate the table, so you add its Next Cell and Next Row commands to the mobile toolbar or use the sidebar buttons instead.
We prefer the built-in editor for most notes, since it needs nothing installed and covers adding, moving and sorting. Advanced Tables earns its place if you work in Source mode and want aligned pipes, or if you want formulas. The README calls the plugin experimental and warns that bugs could delete data in the current note, so keep backups.
Advanced Tables Formulas: Totals and Averages in a Note
Formulas sit in an HTML comment on the line directly after the table. The line starts with TBLFM: and follows a destination equals source pattern modelled on Emacs org-mode.
| Expense | Amount |
| --------- | ------ |
| Hosting | 12 |
| Domain | 15 |
| Plugins | 0 |
| **Total** | |
<!-- TBLFM: @>$2=sum(@I..@-1) -->
When you evaluate it, the empty Total cell fills with 27. Here's how to read the formula, per the formula documentation:
@>$2is the destination: the last row, column 2.@Iis the first row of content below the header.@-1is the row above the cell being filled, so@I..@-1covers every amount.sumadds the range. Swap inmeanfor an average.
Formulas aren't live. You run them with the formulas button in the Advanced Tables toolbar, and the result is written into the cell as plain text. Reading view hides the comment, so the table looks normal to anyone reading the note.
Can You Merge Cells in an Obsidian Table?
No. Obsidian's Markdown tables have no colspan or rowspan, and neither does the built-in editor. You have two workarounds, each with a cost.
Option one is an HTML table, which Obsidian renders in the note:
<table>
<tr><th colspan="2">Q1 budget</th></tr>
<tr><td>Hosting</td><td>12</td></tr>
</table>
Here the header cell spans both columns. Obsidian's help on HTML says it doesn't render Markdown inside HTML elements, though, so wikilinks and bold syntax stop working in those cells. Blank lines inside the block also break it.
Option two is the Table Extended plugin, which adds MultiMarkdown syntax for spanned cells. Its last release dates from January 2022, and its README says it isn't compatible with Advanced Tables. Try it on a copy of a note before you rely on it.
Taking an Obsidian Table to GitHub or Another Editor
An Obsidian table travels well until it holds Obsidian syntax. On GitHub, the GFM table rules consume the backslash in [[Note\|alias]], so the cell shows the literal text [[Note|alias]]. Embeds such as ![[chart.png\|300]] show as text too.
The cleanest fix is to replace each wikilink with a standard link, which needs no escaping:
| Topic | Reference |
| -- | -- |
| Syntax | [Markdown syntax](Basic-formatting-syntax.md) |
GitHub renders a normal clickable link in the cell. Our Obsidian to Markdown converter converts [[wikilinks]], ![[embeds]], callouts and highlights, one pasted or uploaded note at a time. It reads the backslash in \| as part of the link target, though, so delete those backslashes before you paste the table in. Run the result through the Markdown table formatter to align and pad the columns again, then preview the rows in our editor before you commit them. If the table is headed for a spreadsheet instead, our Markdown to Excel guide covers .xlsx and CSV.
One kind of table can't come with you. A Dataview TABLE query draws its table from note metadata each time it runs, so there's no Markdown table in the file to copy. Our Obsidian cheat sheet covers Dataview queries.
A good Obsidian Markdown table starts with the built-in editor, adds a backslash before every pipe inside a link, and uses <br> for multi-line cells. Reach for Advanced Tables when you want formulas or aligned source, and fall back to HTML only for merged cells. When a table leaves your vault, swap wikilinks for standard links and check it in the editor before you paste it anywhere else.