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
- Keep every person's note in one folder. This vault uses
01-People; any name works, and subfolders inside it are fine. - Each note needs
type: personin its properties (the block between the---lines at the top). Notes without it are left out, so your other notes can live anywhere in the vault. - Name the note after the person. For someone who has died, add their years with an en dash:
Daniel Rivera (1948–2019). For someone living, just the name:Grace Holloway. If two people share a name, add a middle initial or a nickname to tell them apart. - Women under their birth (maiden) name, with married names in
aliases.
Properties
Only type: person is required. Everything else makes the tree richer.
side: which side of the family, such asRiveraorHolloway. Each side gets its own colour and its own part of the tree.line: the family lines a person belongs to, as a list. Lines can be shown on their own as a 2D chart.relation: how they're related to you, in your own words. Writeselfon your own note, so Cartogeny knows who goes in the middle.born,died: dates such as1948-03-14,1948-03or1948. Rough dates work too:c.1952,abt 1870,before 1900,after 1850,1890-05 (baptized).birthplace,deathplace: as you'd write them.living:trueorfalse. Setliving: falsefor everyone who has died. Shared copies of your tree hide anyone who isn't, and anyone born in the last 100 years with no death date, to keep living relatives private.confidence: how sure you are, one ofconfirmed,probable,unconfirmedorfamily memory. It sets how the person's links are drawn: solid, faded, dashed or dotted.aliases: other names, as a list (married names, nicknames, spellings).ancestry_id: the person's number on Ancestry, if you also keep your tree there (see below).directandgeneration: optional checks. Give your direct ancestorsdirect: true, withgeneration: 1for parents,2for grandparents and so on. Cartogeny works out generations from the links on its own, and tells you if these disagree.partner_directandpartner_generation: the same, for your partner's direct ancestors.
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]]
- Father, Mother or Parents.
- Spouse(s) (or Husband, Wife, Married) for marriages. Several are fine:
[[A]] (1st), [[B]] (2nd). - Partner(s), or
(with)after a name in the Spouse line, for couples who didn't marry. - Children, as many links as you need.
- A link only has to be written on one side: if a mother lists her son, he's her son even if his note doesn't list her. Cartogeny points out the one-sided ones so you can fill in the other note.
- How sure is this link? Words next to it lower its confidence:
probablyorlikelymakes it probable;(?),possiblyorunconfirmedmakes it unconfirmed;family saysmakes it family memory. - A relative without a note of their own can be plain text, like
José Rivera (family says). Cartogeny lists these as people to write up, but doesn't add them to the tree. - Brothers and sisters come from shared parents, so there's no need to list them.
Pictures
Put pictures in Attachments, in a folder named after the person's note:
Attachments/Photos/Daniel Rivera (1948–2019)/portrait.jpg
Photos,Clippings,GravesandRecordsare the kinds of picture. A picture a note links or embeds is that person's too, wherever it is.- The portrait is the photo named
portrait(orphoto), or the one in aportrait:property. - Shared copies only carry portraits of people who have died. Never clippings, graves or records, since obituaries name living relatives.
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.