Obsidian Internal Link

Official Documentation: help.obsidian.md

Used to link to another Obsidian Note in the same vault; one of the additional syntax options in Obsidian Flavored Markdown.

Syntax

There are two ways to make an Obsidian Internal Link: ¹

• Using the Wikilink format: [[Three laws of motion]]
• Using the Markdown format: [Three laws of motion](Three%20laws%20of%20motion.md)

You can also link to a specific heading of a note by using #. For example: [[Three laws of motion#Second law]].

The display text of an Obsidian Internal Link can be changed in the following ways: ²

• Wikilink Format: [[Three laws of motion|Display Text]]
• Markdown Format: [Display Text](Three%20laws%20of%20motion.md)

When in a table, the pipe character (|) used in the Wikilink format will have to be escaped with a backslash (\). ²

How to use

Always add display text for links. This gives a higher chance of allowing all of the links to be updated without accidentally changing the meaning or structure of the sentence containing the link. ^{3 4}

[!warning]
Do not assume display text is immutable. See: Link display text is not immutable⁴

History