Metadata is a simple key-value format for storing additional information about a document, hidden from export and Preview.

Document Metadata

Document metadata is placed on top of a file, and must be enclosed with three dashes:

---
Author: Jane Smith
Date: January 1
---

Metadata keys can be used as variables in text, and they will be automatically substituted for export and in Preview:

Kind regards,
[%Author]

Global Metadata

Metadata that applies to every file can be defined in Markdown preferencessettings.

Global metadata has the lowest priority, so that a document that explicitly specifies its author will always use that value when a variable is used.

Content Block Metadata

Content block metadata is placed immediately after a content block, optionally enclosed with three dashes:

Letter.text
Name: John Smith
Date: January 2

Content block metadata has the highest priority.

Images support title, alt, width, and height attributes:

Image.png
Title: Pie Chart
Alt: Pie chart with 2 slices: a 50% slice called “left”, and a 50% slice called “right”
Width: 50%