# Markdown syntax

Wander reads and writes standard markdown, with the common Obsidian extensions.

## Text

**bold** · *italic* · ~~strikethrough~~ · ==highlight== · `inline code`

## Citations

Put a BibTeX file named refs.bib at the top of your vault, then cite with the pandoc syntax:

    As shown by [@knuth1984].

Wander renders it as (Knuth, 1984) and suggests keys as you type [@. Your note keeps the plain [@knuth1984] text, so pandoc, Obsidian citation plugins and .typ papers all read the same file.

Open refs.bib itself and you get the references list: add a reference by pasting a DOI, an arXiv link or an ISBN and Wander fetches the details, or enter one by hand. Filter the list, edit an entry, delete one, and see how many notes cite it (click the count to open them). The eye shows the raw BibTeX, and untouched entries keep their exact original text, so a file managed by Zotero or Overleaf survives a round trip unchanged.

## Headings

# Heading 1
## Heading 2
### Heading 3

## Lists

- a bullet
- another bullet
  - nested

1. numbered
2. second

- [ ] a task
- [x] a done task

## Quotes and rules

> a blockquote

---

## Links

[a link](https://wander.md)

[[Welcome]], a wikilink to another note in the vault

## Images

    ![a sunset](attachments/sunset.png)
    ![a sunset|240](attachments/sunset.png "golden hour")

An image fills the content width by default. A width after the `|` sizes it, the quoted title renders as a caption underneath, and images on consecutive lines (no blank line between) sit side by side as a gallery of thumbnails. Right-click an image for the menu: Small, Large, an exact width, a caption, Rename, Delete. Click a small image to see it full size.

It is all standard markdown: Obsidian sizes `![alt|240]` the same way, GitHub simply shows the image at full size, and the caption is the ordinary title text. Nothing wander-specific is written to your file.

## Video and audio

    ![](attachments/clip.mp4)
    ![](attachments/voice.m4a)

The same syntax plays media: a video gets inline controls (a small one, `![|240]`, is a thumbnail with a play badge), and an audio file is a compact player row. Media files also appear in the sidebar and open in a native player.

## Code

```
a fenced code block
```

## Diagrams

```mermaid
graph TD
  idea --> note --> vault
  vault --> anywhere[any markdown app]
```

A ```` ```mermaid ```` fence renders as a live diagram, click it to edit the source, click preview to see it drawn. Works offline; the file keeps plain text. See [[demo/Diagrams]] for more.

A diagram can also be a file of its own: save it as `flow.mermaid` (or `.mmd`) and Wander opens it as the diagram with its source beside it, on the same eye and split buttons. Same renderer, same file, plain text either way.

## Math

Euler's identity $e^{i\pi} + 1 = 0$ sits right in a sentence, and display math gets its own line:

$$\sum_{i=0}^{n} i = \frac{n(n+1)}{2}$$

Write LaTeX between `$…$` (inline) or `$$…$$` (display), the same notation Obsidian uses, so your files work in both. Multi-line blocks work too: put `$$` on its own line, an `aligned` or `cases` environment between. Click a formula to edit its source; click away and it typesets again. Rendering is real print typesetting, offline, and your file keeps the plain `$` text, dollar amounts like $5 are left alone.

## Typst

```typst
= Pricing
#table(columns: 2, [tier], [price], [free], [\$0], [pro], [\$49])
```

A ```` ```typst ```` fence typesets its content, tables, layouts, math, with the same engine behind Math. And `.typ` files are first-class: they appear in the sidebar and open with a Source · Split · Preview control, edit on the left, see typeset pages on the right, click either side to jump to the same spot in the other.

Press space on a `.typ` file in Finder and you get the typeset pages, not the source: Wander compiles it right there, offline. A file that does not compile shows the error and its source instead.

## Tables

| left | right |
| ---- | ----- |
| a    | b     |

See these live in the [[demo/Formatting]] and [[demo/Tables]] pages.