Von Ahnenblatt zur quellenbewerteten Personenakte: GEDCOM, Markdown und YAML in der Praxis

Aktualisiert am 8. August 2026 / in Digitale Archive

Kurz gesagt

Ahnenblatt verwaltet in meinem Familienarchiv Personen, Ereignisse und Familienbeziehungen. Diese Informationen sollen jedoch nicht ausschließlich in einer programmspezifischen Arbeitsdatei verständlich bleiben.

Deshalb erzeuge ich regelmäßig einen vollständigen GEDCOM-Export. Aus diesem maschinenlesbaren Datenstand werden ausgewählte private Personenakten in Markdown abgeglichen und bei Bedarf weiter ausgebaut. YAML hält dabei fest, aus welchem Export eine Akte stammt, wie weit sie geprüft wurde und ob sie veröffentlicht werden darf.

Der praktische Ablauf lautet:

Information oder Beleg
→ Pflege in Ahnenblatt
→ vollständiger datierter GEDCOM-Export
→ lesender Abgleich der betroffenen Personen
→ Markdown-Personenakte mit YAML
→ Sichtkontrolle in Ahnenblatt
→ Quellenbewertung und weiterer Ausbau

Ahnenblatt bleibt die genealogische Arbeitsumgebung. GEDCOM übergibt die Struktur. Markdown erklärt den Personenstand. YAML steuert Herkunft, Bearbeitungsstand und Datenschutz.

Warum die Ahnenblatt-Datei allein nicht genügt

Genealogieprogramme sind sehr gut darin, Eltern, Kinder, Partnerschaften und Lebensereignisse miteinander zu verknüpfen. Eine Programmansicht beantwortet aber nicht automatisch alle Fragen, die für ein dauerhaft verständliches Familienarchiv wichtig sind:

• Welche Quelle bestätigt ein Datum?
• Welche Beziehung stammt nur aus dem bisherigen Arbeitsstand?
• Welche Angabe wurde durch eine Urkunde bestätigt?
• Wo gibt es einen Widerspruch?
• Welche Information bleibt ein offener Prüfhinweis?
• Welche Daten dürfen keinesfalls veröffentlicht werden?

Die Ahnenblatt-Arbeitsdatei bleibt deshalb erhalten, wird aber durch offene und menschenlesbare Repräsentationen ergänzt.

Ahnenblatt bleibt die genealogische Arbeitsumgebung

Neue oder korrigierte Informationen werden zunächst in Ahnenblatt gepflegt. Dazu gehören insbesondere:

• Namen und Namensänderungen,
• Geburt, Taufe, Heirat und Tod,
• Eltern und Kinder,
• Ehen und weitere Partnerschaften,
• Geschwister und Halbgeschwister,
• Quellen- und Medienhinweise.

Bei einzelnen Bearbeitungen rufe ich nicht nur die Ausgangsperson auf. Auch Eltern, Partner, Kinder und weitere Angehörige werden in Ahnenblatt gezielt gesucht. Screenshots ausgewählter Programmansichten können anschließend von Codex gelesen und für die kontrollierte Bearbeitung der Personenakten verwendet werden.

Der Screenshot ist dabei keine vollständige Datenübergabe und normalerweise auch kein genealogischer Originalbeleg. Er ist eine bewusst begrenzte Programmansicht, mit der Personen und Beziehungen sichtbar gemacht und mit dem GEDCOM-Bestand verglichen werden können.

Der vollständige GEDCOM-Export als Übergabestand

Wenn in Ahnenblatt tatsächlich genealogische Daten geändert wurden, exportiere ich anschließend den gesamten Bestand als neue datierte GEDCOM-Datei. Eine reine Sichtkontrolle, Quellenbewertung oder Ergänzung einer Markdown-Akte begründet dagegen keinen neuen GEDCOM-Stand.

Beispiel:

familienarchiv_2026_07_26.ged

Die Datei wird nach dem Export nicht verändert. Sie dokumentiert den geänderten Stand, den Ahnenblatt zu diesem Zeitpunkt ausgegeben hat, und bildet die maschinenlesbare Grundlage für spätere Abgleiche.

Gab es seit dem letzten Export keine Änderung in Ahnenblatt, bleibt der vorhandene GEDCOM-Stand maßgeblich. In diesem Fall wird in einer Personenakte weder ein neuer Export behauptet noch source_system allein wegen des Bearbeitungsdatums aktualisiert.

Der vollständige Export ist wichtig, weil eine Person nicht isoliert betrachtet werden kann. Eltern, Kinder, Partner und Geschwister ergeben sich aus Familienverknüpfungen. Erst der zusammenhängende Bestand erlaubt es, diese Beziehungen nachvollziehbar auszuwerten.

Codex verändert weder die Ahnenblatt-Arbeitsdatei noch den GEDCOM-Export. Die Verarbeitung erfolgt lesend.

Nicht jede Personenakte wird bei jedem Export neu geschrieben

Ein vollständiger GEDCOM-Export bedeutet nicht, dass anschließend sämtliche Markdown-Dateien pauschal ersetzt werden.

Bearbeitet werden die Personen, die für den jeweiligen Vorgang relevant sind. Dabei werden unter anderem geprüft:

• GEDCOM-Kennung und UID,
• Namen und Lebensdaten,
• Eltern-Kind-Verknüpfungen,
• Ehen und Partnerschaften,
• Geschwister über gemeinsame Eltern,
• Abweichungen zu vorhandenen Personenakten,
• vorhandene Quellenbewertungen und offene Hinweise.

Der Abgleich muss feldbezogen erfolgen. Bereits vorhandene Erläuterungen, Dokumentverknüpfungen und Quellenbewertungen dürfen durch einen späteren GEDCOM-Stand nicht überschrieben werden.

GEDCOM-ID und UID in YAML

Eine Personenakte kann ihre Zuordnung zum GEDCOM-Datensatz im YAML-Kopf dokumentieren:

---
title: "Beispielperson"
project: genealogy
content_type: personenakte
scope: private_vertraulich
gedcom_id: "@I123@"
gedcom_uid: "..."
source_system: "Ahnenblatt GEDCOM-Export 2026-07-26"
status: gedcom_abgeglichen
published: false
living_person: true
---

Die laufende GEDCOM-ID erleichtert die Kontrolle innerhalb eines bestimmten Exports. Für die längerfristige Zuordnung ist die UID besonders wichtig. In der Praxis muss dennoch geprüft werden, ob Ahnenblatt diese Kennungen über mehrere Exporte stabil beibehält.

source_system nennt den tatsächlich verwendeten Exportstand. Das Feld wird nur dann auf einen neuen Stand gesetzt, wenn eine nach wirklichen Änderungen erzeugte GEDCOM-Datei für diese Person tatsächlich ausgewertet wurde. Der Status zeigt, wie weit die Akte fachlich bearbeitet wurde. Datenschutz und Veröffentlichung werden davon unabhängig gesteuert.

Von GEDCOM-Grunddaten zur verständlichen Personenakte

GEDCOM liefert das genealogische Gerüst. Eine ausgebaute Markdown-Akte enthält darüber hinaus:

• verständlich formulierte Stammdaten,
• Links zu den Akten der Angehörigen,
• historische und familienrechtliche Zusammenhänge,
• Verknüpfungen zu Originaldokumenten,
• eine Bewertung der verwendeten Quellen,
• offene Prüfhinweise,
• Datenschutz- und Veröffentlichungsstatus.

Eine solche Akte ist keine zweite Genealogiedatenbank. Sie macht vielmehr verständlich, was zu einer Person bekannt ist, woher die Angaben stammen und wie sicher sie bewertet werden.

Angehörige werden gezielt mitverarbeitet

Bei der Bearbeitung einer Person werden auch die in Ahnenblatt erkennbaren Angehörigen berücksichtigt. Vorhandene Personenakten können dadurch miteinander verlinkt werden.

Beispiele:

Ausgangsperson
├── Eltern
├── Partner
├── Kinder
└── Geschwister

Geschwister werden nicht allein aus einem gleichen Nachnamen abgeleitet. Entscheidend sind gemeinsame Elternverknüpfungen. Bei nur einem gemeinsamen Elternteil handelt es sich um Halbgeschwister.

Unklare oder abgeschnittene Angaben aus einer Programmansicht werden nicht erraten. Fehlt eine eindeutige Zuordnung, bleibt die Beziehung offen.

Quellen haben unterschiedliche Aussagekraft

Nicht jede Information ist gleich belastbar. Für die Personenakten unterscheide ich deshalb unter anderem:

Stimmen GEDCOM, Programmansicht und ein Originalbeleg überein, kann eine Angabe entsprechend sicher dokumentiert werden.

Enthält dagegen nur eine externe Quelle eine zusätzliche Beziehung, wird sie nicht automatisch in die bestätigte Familienliste aufgenommen. Sie bleibt als offener Prüfhinweis erhalten.

Nicht im GEDCOM enthalten bedeutet dabei nicht automatisch falsch. Es bedeutet zunächst nur, dass der aktuelle Ahnenblatt-Export diese Beziehung nicht bestätigt.

Bearbeitungsstand sichtbar machen

Für die private Arbeitsorganisation sind abgestufte Zustände sinnvoll. Das vorhandene Statusschema der jeweiligen Akten ist maßgeblich. Inhaltlich lassen sich beispielsweise folgende Stufen unterscheiden:

aus GEDCOM übernommen
→ mit GEDCOM und Programmansicht abgeglichen
→ Quellen teilweise erschlossen
→ Quellen systematisch erschlossen

Eine quellenerschlossene Akte muss nicht zwangsläufig für jedes einzelne Feld bereits einen amtlichen Nachweis enthalten. Entscheidend ist, dass die vorhandenen Quellen benannt, bewertet und noch offene Nachweise sichtbar gemacht werden.

Datenschutz ist keine Nebenfrage

Die GEDCOM-Datei kann wesentlich mehr personenbezogene Informationen enthalten, als für eine lesbare Personenakte erforderlich sind.

Deshalb werden nicht automatisch übernommen:

• aktuelle Anschriften,
• Telefonnummern,
• E-Mail-Adressen,
• unnötige technische Programmfelder,
• ungeprüfte Online-Beziehungen,
• Informationen ohne Bezug zum Archivzweck.

Eine verstorbene Person wird nicht automatisch veröffentlicht. Ebenso wenig führt eine vollständig ausgebaute Akte automatisch zu einer Freigabe.

YAML trennt diese Entscheidungen:

scope: private_vertraulich
published: false
living_person: false

Privatheit, Lebensstatus und Veröffentlichungsentscheidung bleiben eigenständige Merkmale.

Spätere GEDCOM-Exporte dürfen die redaktionelle Arbeit nicht zerstören

Mit der Zeit werden Personenakten durch Urkunden, Registerauszüge, Briefe, Fotos und weitere Hinweise ergänzt. Diese redaktionelle Arbeit darf bei einem späteren GEDCOM-Abgleich nicht verloren gehen.

Geschützt bleiben insbesondere:

• Dokumentverknüpfungen,
• Quellenbewertungen,
• historische Erläuterungen,
• offene Konflikte,
• manuell formulierte Familienzusammenhänge,
• Datenschutztexte,
• Veröffentlichungsentscheidungen.

Ein neuer Export kann neue oder geänderte Grunddaten liefern. Abweichungen werden aber zunächst geprüft. Eine automatische Rückschreibung in Ahnenblatt findet nicht statt.

Die Rollen bleiben klar getrennt

Diese Trennung verhindert, dass ein einzelnes Programm zur alleinigen Wahrheitsinstanz wird.

Grenzen des Verfahrens

Markdown ersetzt keine Stammbaumansicht. GEDCOM überträgt nicht zwangsläufig jede programmspezifische Besonderheit. Screenshots sind nicht maschinenlesbar wie ein vollständiger Export. Auch Codex kann nur die Informationen verarbeiten, die eindeutig übergeben wurden.

Der Ablauf funktioniert deshalb nur mit:

• unveränderten, datierten GEDCOM-Exporten nach tatsächlichen Änderungen,
• eindeutiger Zuordnung der Personen,
• sichtbarer Quellenbewertung,
• kontrolliertem Umgang mit Widersprüchen,
• Schutz manueller Ergänzungen,
• menschlicher Abschlussprüfung.

Optional: Änderungen zusätzlich mit Git dokumentieren

Git gehört nicht zwingend zu diesem fachlichen Ablauf. Wer seine privaten Markdown-Personenakten jedoch versioniert, kann Änderungen zusätzlich nachvollziehbar festhalten und frühere Textstände vergleichen. Das ersetzt weder den datierten GEDCOM-Export noch die Quellenbewertung in der Personenakte. Die Vor- und Nachteile erläutert der Beitrag Für und wider Git.

Fazit

Mein Familienarchiv verbindet die Stärken mehrerer Werkzeuge:

Ahnenblatt strukturiert. GEDCOM übergibt. Die Programmansicht kontrolliert. Markdown erklärt. YAML steuert. Der Mensch entscheidet.

Die vollständige GEDCOM-Datei bewahrt den maschinenlesbaren Zusammenhang des genealogischen Bestands. Die Personenakten machen ausgewählte Personen und ihre Angehörigen verständlich. Originalquellen und ihre Bewertung bestimmen, welche Aussagen langfristig als belastbar gelten.

So bleibt das Familienwissen nicht nur austauschbar, sondern auch nachvollziehbar.