1# Obsidian
2
3sublimated supports most Obsidian markdown extensions. push your vault via [git](../git/) and it renders correctly on the web.
4
5see [markdown syntax](../markdown/syntax.md) for the full syntax reference, or [demo](../markdown/demo.md) to see everything rendered.
6
7## what works
8
9- wikilinks — `[[page]]` and `[[page|display text]]` resolve to files in your space
10- embeds — `![[file]]` embeds images, documents, and other content inline
11- block IDs — `^blockid` at the end of a paragraph or heading creates a stable anchor
12- block references — `[[page#^blockid]]` links to a specific block
13- heading references — `[[page#heading]]` links to a specific section
14- frontmatter — YAML between `---` delimiters, stored and queryable
15- task lists — `- [ ]` and `- [x]`
16- tables, strikethrough, highlights
17- [dataview queries](dataview.md) — DQL code blocks and inline expressions
18
19## embeds
20
21```markdown
22![[photo.png]]              embed an image
23![[photo.png|300]]          with width
24![[photo.png|300x200]]      with width and height
25![[document.md]]            embed another document
26![[document.md#section]]    embed a specific section
27![[document.md^blockid]]    embed a specific block
28```
29
30sublimated also supports [iA Writer](../markdown/ia-writer.md) content blocks (`/path/to/file`) as an alternative embed syntax.
31
32## wikilinks
33
34```markdown
35[[meeting-notes]]           links to meeting-notes.md
36[[projects/roadmap]]        links to projects/roadmap.md
37[[roadmap|Our Roadmap]]     custom display text
38```
39
40links resolve from your space root.
41
42## block IDs
43
44```markdown
45This is an important paragraph. ^important
46
47## Section heading ^intro
48```
49
50reference from other files with `[[page#^important]]` or embed with `![[page#^important]]`.
51
52## pushing your vault
53
54```bash
55cd my-vault
56git init
57git add . && git commit -m "initial"
58git remote add origin https://sublimated.com/{your-space}/vault.git
59git push -u origin main
60```
61
62your vault is now browsable at `sublimated.com/{your-space}/vault` with all wikilinks and embeds working. see [git](../git/) for more on cloning and pushing.
63
64## what's different
65
66- sublimated resolves wikilinks from the space root, not relative to the current file
67- Obsidian plugins and custom CSS don't carry over — only the markdown content
68- `.obsidian/` config folder is ignored for rendering