Wikilink pipe alias | inside markdown tables parsed as table delimiter instead of link alias

The problem:

When you write a table cell with a wikilink alias:

Name Link
Test [[World/Reference/Helious

Obsidian sees FOUR pipe characters on that row instead of three:

| Test | [[World/Reference/Helious | Helious]] |

It splits on every | character left to right, treating the pipe inside the wikilink as a column separator. So the link breaks into two malformed cells — one containing [[World/Reference/Helious and one containing Helious]].

Why this is wrong:

Markdown parsers are supposed to resolve inline elements (links, bold, code spans) BEFORE splitting table rows into cells. The [[…]] wikilink brackets define a self-contained token. The | inside that token is part of the link syntax,
not part of the table syntax. Just like you wouldn’t expect | bold | text | to break bold formatting at the pipe, the wikilink pipe should be invisible to the table parser.

The correct behavior:

The parser should:

  1. Scan for wikilink tokens [[…]] and treat their contents as opaque
  2. THEN split the remaining text on | for table columns
  3. The alias pipe never reaches the table parser because it’s already consumed by the link parser

The workaround we’re using:

We strip the alias from links inside tables — [[World/Reference/Helious]] — which means those links display the full path instead of just the filename. It works but it’s ugly and defeats the purpose of aliases.

I don’t know how you write your table (more precisely) but, as a workaround, you should be able to escape the pipe before the alias/display text with a backslash in a table :blush:

So, the wikilink in the table would be something:

[[Title of my note\|Alias]]

… as mentioned in the callout titled “Vertical bars in tables” on this documentation page :blush:

If you add a wikilink in a table from Live Preview tough, I think that Obsidian auto-escape the pipe before the alias/display text (I’m 90% sure it does but I could still be wrong :sweat_smile: )

Duplicate of: