Decision: Drop [[wikilinks]] permanently
See /spec for the public statement. This is the internal "why" we don't surface in marketing.
What we're not building
[[wikilinks]] syntax. No [[target]], no [[target|alias]], no autocomplete on [[, no per-page backlinks panel built off literal-text matches. None of it.
The argument from the Obsidian side
"You can't be a wiki without wikilinks. Every wiki shape since Ward Cunningham has had them." True. We're not building a wiki shape. We're building a hub shape, which is wiki-adjacent but doesn't require the same syntax bet.
Three reasons I went the other way
- The links should come from the AI, not the markup. mdfy already maintains a
concept_indexandconcept_relationsgraph that's automatically populated by the AI capture passes. The graph is more interesting than what a user remembers to write inside[[ ]]. Putting both up would be redundant and the manual one would always lose. - Wikilinks are a friction tax on AI agents. When Claude or Cursor reads a markdown doc with
[[]]syntax, it can't follow the link without the wiki-context ([[]]is not standard markdown; the resolution is hub-specific). Plain inline links ([label](https://mdfy.app/d/abc123)) work everywhere. - It would freeze us into a wiki-product mental model. Once users have
[[]]reflexes, every UI decision down the line gets compared to Obsidian. That's the wrong reference for cross-AI memory.
What we ship instead
- Auto-generated "Related in this hub" panel under every doc, computed from the concept overlap with sibling docs.
- Concept index page at
/hub/{slug}/concepts, browsable. - Linting for hubs (orphans, likely-duplicates, title mismatches).
What I expect to hear
"Power users will hate this." Yes — the subset of power users who already think in [[]]. I'm willing to lose them. The mass market is everyone who's never used Obsidian, and for them the AI-derived link is strictly better than the markup they'd have to learn.