Skip to content

Prefer standard markdown hyperlinks

When writing notes in markdown, prefer to use standard [](./path) style markdown hyperlinks over [[rough name match]] style wikilinks.

Assuming that you navigate notes through links and search, markdown hyperlinks provide a stable and direct way of linking. These links are portable, and don't change when a note's title or content is updated over time.

There is a trade-off. Markdown hyperlinks can be slower to type than wikilinks, and the ability to follow a wikilink and have it treated as a search in some software is very useful. Performing manual real-time searches using tools like fzf and ripgrep can beat this cost, and snippet tools exist for most text-editors to allow automatic typing of the hyperlink markup.

References