# Links and Embeds
> [!abstract] What this note is
> How to connect notes — the feature Obsidian exists for. Internal links (`[[ ]]`), external links, linking to headings and blocks, and embedding one note inside another.
## Internal links (wikilinks)
Double square brackets around a note's name:
```markdown
[[Vault Schema]]
[[Vault Schema|the blueprint]] ← shows "the blueprint" as the link text
```
- You don't need the folder path or `.md` — the note name is enough.
- Linking to a note that doesn't exist yet is *allowed and encouraged*: the link renders grayed-out, and clicking it creates the note. This is how vaults grow.
- Renaming a note updates every link to it automatically (this vault has `alwaysUpdateLinks` on).
## Linking to a heading or block
```markdown
[[Vault Schema#Naming rules]] ← jumps to a heading
[[2026-07-10 Friday#^abc123]] ← jumps to a specific block
```
Type `[[Note Name#` and Obsidian lists the headings for you. For block links, type `#^` and pick a block — Obsidian adds the `^abc123` marker itself.
## External links
```markdown
[Obsidian Help](https://help.obsidian.md)
```
Square brackets for the text, parentheses for the URL — *the reverse feels natural to everyone at first; everyone gets it backwards for a week.*
## Embeds — showing content, not just linking it
Add `!` in front of a wikilink and the content appears *inside* the current note:
```markdown
![[argus-9001.webp]] ← shows the image
![[Vault Schema#Folder map]] ← shows just that section, live
```
Embeds are live views, not copies — edit the source and every embed updates.
## Which link style should I use?
**Wikilinks for notes, Markdown links for the web.** That's this vault's convention and the Obsidian default.
## Related
- [[Images and Attachments]] — more on embedding files
- [[Markdown Reference Index]]