markdown

sublimated renders markdown files when you browse them on the web. push .md files via git and they're displayed with full formatting.

supported syntax

standard markdown plus GitHub Flavored Markdown (GFM):

• headings (# h1 through ###### h6)

• bold, italic, strikethrough

• links and images

• ordered and unordered lists

• task lists (- [ ] and - [x])

• tables

• code blocks with syntax highlighting

• blockquotes

• horizontal rules

• inline code

• autolinks (URLs become clickable)

extensions

beyond standard markdown, sublimated supports:

• frontmatter — YAML metadata at the top of files

• wikilinks — link between files with [[page]]

• citations — reference .bib entries with [@key]

• content blocks — embed other files inline

• block IDs — anchor to specific blocks with ^id

• raw HTML passthrough

frontmatter

YAML between --- delimiters at the top of a file:

---
title: My Post
tags: [blog, update]
draft: false
---


# My Post


content here...

frontmatter is extracted and used for metadata — titles, descriptions, tags.

wikilinks

link to other files in your space:

[[pricing]]           links to pricing.md
[[docs/setup]]        links to docs/setup.md
[[setup|Get Started]] links to setup.md, displays "Get Started"

wikilinks resolve relative to your space root.

citations

reference bibliography entries using Pandoc-style syntax:

[@key]                normal citation
[-@key]               suppress author name
[@key, p. 42]         with page locator
[@key1; @key2]        multiple citations

citations link to entries in .bib files in your space. push a references.bib file and cite from any markdown file.

content blocks

embed other files inline. two syntaxes are supported:

iA Writer style:

/data/chart.csv
/images/diagram.png

a path on its own line embeds that file.

Obsidian style:

![[chart.csv]]
![[diagram.png]]
![[diagram.png|300]]        with width
![[diagram.png|300x200]]    with width and height
![[doc#heading]]            embed a specific section
![[doc^blockid]]            embed a specific block

see obsidian and ia-writer for full compatibility details.

block IDs

add stable anchors to any block using Obsidian's ^id syntax:

This is an important paragraph. ^important


## Section heading ^intro

block IDs let you link to specific parts of a document: [[page#^important]]

editor compatibility

sublimated works with markdown editors you already use:

• Obsidian — wikilinks, embeds, block IDs, frontmatter

• iA Writer — content blocks, frontmatter

• any editor that writes standard markdown or GFM

reference

• syntax — complete syntax reference with examples

• demo — a live example file you can push to your space