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