Markdown body

The markdown body is everything after the closing ---. It supports standard markdown with Typedown extensions. This page covers every supported syntax element.

Headings ​

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

Headings generate anchors and appear in the table of contents.

Text formatting ​

Code blocks ​

Fenced code blocks with optional language label and line ranges:

```python
def greet(name):
    return f"Hello, {name}!"
```

Line highlighting with ranges:

```js{1,3,5-8}
const a = 1;
const b = 2;
const c = 3;
```

The opening and closing fence must have the same number of backticks.

Math ​

Inline math with single $:

The formula is $E = mc^2$.

Renders as: The formula is $E=m{c}^2$.

Block math with $$:

$$
\int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
$$

Renders as:

Math content is raw text. No interpolation inside math blocks.

Blockquotes ​

> This is a blockquote.

This is a blockquote.

Tables ​

| Name  | Age |
| ----- | --- |
| Alice | 30  |
| Bob   | 25  |

Lists ​

Bullet lists:

- item one
- item two
  - nested item

Ordered lists:

1. first
2. second
   1. nested

Task lists:

- [x] done
- [ ] todo

Links and images ​

[Example](https://example.com)
[Alice](people/alice)
![alt text](_assets/photo.jpg)

Links to .td files are resolved relative to the vault root. The .td extension can be omitted.

String interpolation ​

Use ${...} to embed expressions in the body:

This task is assigned to ${self.assignee.name}.
Total items: ${self.items.length()}.

Expressions are evaluated at build time.

Callout blocks ​

Callout blocks use ::: with a type label:

::: note
This is a note.
:::

Available types: note, tip, warning, danger, details, info.

The details type creates a collapsible section with a title:

::: details Click to expand
Hidden content.
:::

Custom components ​

Custom components can be used with two syntaxes.

Container syntax wraps content in a named block:

::: component-name {prop="value"}
Content goes here.
:::

Shorthand syntax for self-closing components:

[[component-name]]
[[component-name {prop="value"}]]

Built-in components ​

Limitations ​

• HTML tags are not supported. Typedown focuses on document structure.

• Indentation-based code blocks are not supported. Use fenced code blocks.