GEDCOM for Obsidian
GEDCOM language support by Domorium. Read a .ged or .gedcom file as
genealogy — people, families, sources and what each fact rests on — and edit its
source directly in Obsidian with validation, autocomplete, navigation, folding,
and semantic highlighting.
Part of Domorium. The same GEDCOM language
support runs in VS Code,
JetBrains IDEs,
and in the browser — one implementation of the format,
adapted per editor.
Features
- An optional genealogy interface, off until you turn it on: a graph and a
timeline of the whole file, a sortable list of its people, families,
sources, media, shared notes, repositories and other records, and a record card in the right sidebar that shows the selected
record as a tree of its lines
- Context-aware GEDCOM tag autocomplete
- Real-time validation errors and warnings
- Semantic highlighting for levels, tags, and cross-references
- Documentation tooltips for GEDCOM tags
- Go to definition for XREF values
- Find XREF references and highlight declarations and usages
- Safe XREF rename as one undoable edit
- Web links and vault-relative file links
- Photographs previewed from a
FILE payload, cropped to the part of the image
a multimedia link asks for
- Quick fixes for broken references and invalid levels
- Folding and visual indentation for nested records
- Highlighted and checked
gedcom code blocks in notes
- Links from a note to a record, indexed by the vault or as an
obsidian:// URL
- Desktop and mobile Obsidian support
The plugin keeps the GEDCOM file as the source of truth. It does not convert
records into Markdown, create a second genealogy database, or send vault data
to a remote service.
Usage
- Enable GEDCOM in Settings → Community plugins.
- Open a
.ged or .gedcom file in your vault. It opens in the editor, and
Obsidian saves changes back to the same file.
- To read the file as people and sources, turn on Genealogy interface (beta)
in the plugin settings; it is still a beta and may change. Files then open in
Graph mode, and the mode buttons in the view header, with the commands
Show as graph, Show as timeline, Show as list and Show as
source, go between its four modes.
The next paragraphs — the modes of a tab and the record card — are
part of the genealogy interface and appear only while it is on; turning it off
hides it again and closes its panels without losing the mode a tab was in. The
editor features after them need no setting.
A GEDCOM tab shows its file in four modes — Graph, Timeline, List
and Source — which the four buttons in the tab's header choose, left to
right in that order, the current mode's in the accent colour. The commands
Show as graph, Show as timeline, Show as list and Show as
source, from the command palette or the tab's menu, do the same, and Switch
between source and the last view goes back and forth between Source and the
mode before it. The graph, the timeline and the list read the tab's own text, so
what is typed and not yet saved is already in them. Find, and its key, opens
the search of the mode the tab is in: the editor's panel in Source, the search
over the board in Graph and Timeline, and the filter field in List;
Replace stays in Source.
In List mode the tab shows the file's people, families, sources,
media, shared notes, repositories or other records as a table, switched by the
buttons at its top, or by one dropdown where the toolbar is too narrow for the
seven buttons in the language shown. People show name, years, place and
how many sources the record cites, with a mark where it cites none; families
show the spouses, the year and place of the marriage and the number of
children; sources show the title, author, repository and how many records cite
them. Media show the title, file,
format and how many records link them; notes their first line and how many
records link them, and the search reads their whole text; repositories their
name, address and how many sources point at them; and Other lists the file's
header first, then submitters, submission records and records of the file's own,
with their kind and name. A click on a column header sorts by it, a second click reverses the order
and a third restores the file's; a filter field narrows the rows by name, year
and place. Sorting people by Sources puts those whose records cite no source
first. A count says how many rows are shown. Clicking a row, or pressing Enter
or Space on it, selects that record. The row of the selected record is marked
and brought into view when it was selected elsewhere. The arrow keys, Home,
End and the page keys move through the rows. A file of twenty thousand people
draws only the rows in view. On a phone, and in a tab narrower than
640 pixels, each row takes two lines and a selector with a direction button
replaces the column headers.
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
