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%