Cartogeny Download the starter vault

Note format

How Cartogeny reads your notes

Cartogeny draws your family tree from plain Markdown notes, one per person. It only reads them: your research stays in files you own, and nothing is uploaded. This page is everything it looks for. The three people in 01-People are worked examples.

One note per person

Properties

Only type: person is required. Everything else makes the tree richer.

The Family section

Relatives are links under a ## Family heading, one kind per line:

## Family
- **Father:** [[Daniel Rivera (1948–2019)]]
- **Mother:** [[Grace Holloway]]
- **Spouse(s):** [[Sam Okafor]]
- **Children:** [[Mia Rivera]], [[Leo Rivera]]

Pictures

Put pictures in Attachments, in a folder named after the person's note:

Attachments/Photos/Daniel Rivera (1948–2019)/portrait.jpg

Your Ancestry tree

If your tree is also on Ancestry, export it (Trees → your tree → Tree settings → Export tree) and save the .ged file anywhere in the vault; this one has a folder for it, 03-Sources/Ancestry. Cartogeny matches people by ancestry_id and adds the ones you haven't written notes for yet, as unconfirmed. Your notes always win, and nothing goes back to Ancestry.

Starting from scratch with a tree on Ancestry? In Cartogeny's Open your own vault, choose Make one from your Ancestry export instead. It writes a whole new vault from the export, a note for every person in this format, all unconfirmed until you check them against records.

Opening your tree

In Cartogeny, click Open your own vault and choose this folder. It reads your notes right there in the browser and asks who goes in the middle. After you change your notes in Obsidian, Read again picks up the changes.

The Research panel lists what needs work: dead ends, weak links, one-sided links and notes it couldn't read. Fixes always happen in your notes; Cartogeny never changes them.