One YAML frontmatter block becomes one card. Markdown after the block becomes its note.

---
id: acme
type: organization
title: Acme Corp
subtitle: Municipal · 9 members
description: The account everything else routes through.
weight: lead
tags: [prospect, warm]
---

Everything here is the note. Headings, lists, tables, links, and **emphasis**
render normally.

Card fields

Field	What it controls	Default
`type`	The category and color. Use any name.	`note`
`id`	The target used by relationships and wikilinks.	slug of the title
`title` or `name`	Card title.	first body heading, then `Untitled`
`subtitle`	One line below the title.	none
`description`	Opening paragraph in the note view.	none
`weight`	How strongly the card draws.	`normal`
`tags`	Chips on the card and in its details.	none
`rel`, `rels`, or `links`	Named connections to other IDs.	none

Only type and a title are usually worth writing by hand.

IDs and links

IDs are slugged. Acme Corp, acme corp, and acme-corp all resolve to acme-corp. This lets [[Acme Corp]] find a card with id: acme-corp.

Set id: yourself when a title may change or two cards have the same title.

Add your own fields

Any unreserved frontmatter key appears as a labeled row in the note view.

website: riversidecity.gov
email: dana@riversidecity.gov
phone: +1 360 555 0142
stage: Qualified
channels: [email, print]
last_contact: 2026-05-14

URLs, domains, email addresses, and phone numbers become links. Strings, numbers, dates, booleans, and arrays render. Nested objects are skipped.

Weight

Use weight for priority, not card size.

Tier	Also accepts	Result
`lead`	`5`, `critical`, `primary`, `key`	strongest stroke and halo
`major`	`4`, `high`	strong stroke
`normal`	`3`, `medium`, `default`	default
`minor`	`2`, `low`	quieter
`faint`	`1`, `background`, `trivial`	quietest

Put several cards in one file

Start each card with another frontmatter block:

---
id: first
type: note
title: First
---

Note for the first card.

---
id: second
type: note
title: Second
---

Note for the second card.

A --- line only starts a card when the next non-blank line looks like a YAML key. Otherwise it remains a normal Markdown horizontal rule. Text before the first frontmatter block is ignored.

Linked but undefined cards

If a relationship points to an ID with no card block, md2hd keeps the connection and draws a dashed gray card. Add the missing block or correct the target ID to resolve it.