Research / Constructs / Obsidian syntax
Obsidian syntax in five publishing editors
One Markdown fixture, five real publishing editors, tested 2026-08-24. For obsidian syntax the observed result was untested in LinkedIn; a manual step in WordPress, Substack, Beehiiv, and X. Every row below is a rule with its own page and its own dated record.
Matches obsidian_wikilink, obsidian_embed, obsidian_callout, obsidian_blockref. Fixture markdown-portability-test-v1. Tested 2026-08-24. How these tests are run.
What happens, per destination
| Destination | What happens | Result | Severity | Rule | Confidence | Last tested |
|---|---|---|---|---|---|---|
| Math, Mermaid, Obsidian syntax, raw HTML, and heading anchors are not live-verified on LinkedIn. | Unknown | Evidence gap | LI-SPECIAL-01 | Unknown | 2026-08-24 | |
| WordPress | Obsidian syntax is flattened to ordinary text. | Manual step | Action | WP-OBS-01 | Verified | 2026-08-24 |
| Substack | Obsidian syntax is flattened to ordinary rich content. | Manual step | Action | SUB-OBS-01 | Verified | 2026-08-24 |
| Beehiiv | Obsidian syntax is flattened to ordinary text. | Manual step | Action | BEE-OBS-01 | Verified | 2026-08-24 |
| X | Math, Mermaid, Obsidian syntax, and raw HTML are resolved to readable text or a media task. | Manual step | Action | X-SPECIAL-01 | Verified | 2026-08-24 |
Manual steps this creates
- LinkedIn: Check this part of the output yourself before posting. (The focused standard-post test did not isolate these constructs, so no reliable claim exists yet.)
- WordPress: Check each flattened target still makes sense, and resolve any missing vault file. (Wiki links, transclusion, callout markers, and block references stayed literal.)
- Substack: Check each flattened target still makes sense to a reader. (Wiki links and transclusions stayed literal and the callout degraded to a quote.)
- Beehiiv: Check each flattened target still makes sense to a reader. (Wiki links and transclusions stayed literal and callouts became plain quotes.)
- X: Check each one reads correctly, or attach it as an image. (The composer has no control for any of these and the focused test did not isolate each one.)
Limits of what was tested
- Each result describes the surface named beside it, on the date named beside it, and nothing wider.
- A result marked unknown means no dated test covers it. It is not a prediction.
- Rendering is not the same across platform versions, themes, plugins, or email clients.
Prepare a draft
- Check your own draft against all five destinations
- Markdown to WordPress, handoff mode: gutenberg paste
- Markdown to Substack, handoff mode: rich html clipboard
- Markdown to Beehiiv, handoff mode: clean markdown paste
- Markdown to X, handoff mode: plain text
- Markdown to LinkedIn, handoff mode: plain text
Related
- The 5 rules behind this page:
BEE-OBS-01,LI-SPECIAL-01,SUB-OBS-01,WP-OBS-01,X-SPECIAL-01 - Every construct, side by side
- The full five-destination matrix