Header + paragraph

This is the default format. Each heading at the configured level (H2 by default) is a front; the body below it is the back.

---
tags: [decks/spanish]
---

## What does "Hola" mean in English?

Hello.

## How do you say "Thank you" in Spanish?

Gracias.

The filename becomes the deck name. The first heading reviews like this:

Front

What does "Hola" mean in English?

Back

Hello.

Two headings, two cards.

Header level & breadcrumbs

The header level is configurable per profile (H2 by default). Headings above the configured level aren’t turned into cards — instead they’re kept as a breadcrumb path attached to each card for context, for example:

Chapter 1 › Section 2

This lets you keep a normal document outline while only the deepest headings become cards.

Choosing a level is really choosing how much of your note is a card. H2 suits a note where each section is one idea. If you write long documents with H2 as chapter titles, set the level to H3 and your chapters become breadcrumbs rather than enormous cards. Title turns the whole file into a single card — see Title cards.

The level is set per profile, which means per tag, so a #decks/lectures note and a #decks/vocab note can use different levels in the same vault.

What the back can hold

The back is everything between the heading and the next heading at the same level, so unlike a table cell it can hold whatever markdown you like — multiple paragraphs, lists, code blocks, callouts, images, LaTeX. Obsidian renders it during review the same way it renders it in the note.

Cards do get harder to recall the longer they are. If a back has grown into three paragraphs covering several facts, that is usually a sign it should be several cards; the AI refactor tools can split a dense card into atomic ones if you would rather not do it by hand.

Adding notes (hints / mnemonics)

You can attach an optional note to a header-paragraph card in two ways:

• An Obsidian comment anywhere in the body: %%a hint or mnemonic%%
• Text placed after a --- divider at the end of the body.

Notes are hidden during review and shown on demand when you press N — the same as the tables notes column.

## What is the capital of Australia?

Canberra.

%%Not Sydney — common trap.%%

Front

What is the capital of Australia?

Back

Canberra.

Notes

Not Sydney — common trap.

The note stays hidden until you press N.

A note is the right place for the thing that would otherwise make you fail a card unfairly — a disambiguation, a mnemonic, the trap you fell into last time. Because it is hidden until you ask for it, adding one does not make the card easier; it just stops you re-deriving the same clarification every time.

Rewording a card

Editing the heading does not reset the card. DecksMD writes a small hidden marker next to each card so its identity survives rewording, moving and reordering, and your review history follows the edit. Even if a card is deleted and later recreated with the same front, its previous scheduling state is restored from the review log.