1# syntax reference
2
3complete reference of markdown syntax supported by sublimated.
3complete reference of markdown syntax supported by sublimated. see [demo](demo.md) to view all features rendered.
4
5## headings
6
7```markdown
113 unmodified lines
121```
122
123## frontmatter
124
125YAML metadata at the top of the file:
125YAML metadata at the top of the file. supported by both [Obsidian](obsidian.md) and [iA Writer](ia-writer.md).
126
127```markdown
128---
129title: Page Title
4 unmodified lines
134```
135
136## wikilinks
137
138internal links using [Obsidian](obsidian.md)-style syntax:
139
140```markdown
141[[page]]                  link to page.md
142[[folder/page]]           link to folder/page.md
143[[page|display text]]     link with custom text
144[[page#heading]]          link to a heading
145[[page#^blockid]]         link to a block
146```
147
148wikilinks resolve from your space root. see [obsidian](obsidian.md) for more on how links work with vaults.
149
150## citations
151
152reference bibliography entries using [Pandoc](https://pandoc.org/chunkedhtml-demo/8.20-citation-syntax.html)-style syntax:
153
154```markdown
155[@smith2024]              cite a reference
156[-@smith2024]             suppress author name
157[@smith2024, p. 42]       with locator
158[@smith2024; @jones2023]  multiple references
159```
160
155requires a `.bib` file in your space.
161requires a `.bib` file in your space. push a `references.bib` and cite from any markdown file.
162
163## content blocks
164
159embed other files inline:
165embed other files inline. two syntaxes are supported:
166
167[Obsidian](obsidian.md) embeds:
168
169```markdown
162![[file.png]]             Obsidian embed
170![[file.png]]             embed a file
171![[file.png|300]]         with width
164/data/chart.csv           iA Writer content block
172![[file.png|300x200]]     with width and height
173![[doc#heading]]          embed a section
174![[doc^blockid]]          embed a block
175```
176
177[iA Writer](ia-writer.md) content blocks:
178
179```markdown
180/data/chart.csv
181/images/diagram.png
182```
183
184see [obsidian](obsidian.md) and [ia-writer](ia-writer.md) for full details on each syntax.
185
186## block IDs
187
188stable anchors using [Obsidian](obsidian.md)'s `^id` syntax:
189
190```markdown
191This paragraph has an anchor. ^my-id
192
193## This heading has an anchor ^intro
194```
195
175reference with `[[page#^my-id]]`.
196reference from other documents with `[[page#^my-id]]`. see [obsidian](obsidian.md) for more on block references.