GEDCOM ecosystem

GEDCOM tools, wherever you work.

Plugins and extensions that bring GEDCOM editing, validation and navigation to the applications you already use — and a browser editor that runs the same parser on your own machine.

  • Open source
  • Cross-platform
  • Nothing is uploaded
  • GEDCOM 5.5.1 / 7.0
Visual Studio Code with simpsons70.ged open. Typing 1 BIR offers BIRT and BURI with their meanings; accepting BIRT leaves a warning that the tag asserts nothing, and adding 2 DATE 24 MAY 1899 under it clears the file to no problems.
A note about Marie Skłodowska-Curie in an Obsidian vault. Resting on the link to her record shows the whole record without opening anything; following it opens curie.ged at that record.
WebStorm with simpsons70.ged open. Go to definition on the cross-reference in Abraham Simpson's FAMS line jumps to the family record that holds his wife and son, and the back gesture returns to where it started.
Extensions

Bring GEDCOM to the tools you already use.

One language service backs all of them, so a diagnostic reads the same wherever you meet it.

  • VS Code

    released

    A web extension as well, so it runs in vscode.dev with no local runtime.

    A completion list open in Visual Studio Code over Abraham Simpson's record, offering BIRT and BURI with their meanings beside them.
    • Find references
    • Safe rename
    • Outline
    • Colour on open
    • Fenced blocks
    • Indentation hints
    • Photograph preview
  • Obsidian

    released

    Desktop and mobile. Vault files are edited in place, never converted to Markdown.

    A photograph previewed in Obsidian, cropped to one person and captioned “Marie, on the left”, beside the CROP lines of the record that asks for that rectangle.
    • Find references
    • Safe rename
    • Fenced blocks
    • Indentation hints
    • Photograph preview
    • Preview beside the file
    • Note to record links
    • A whole folder
  • JetBrains

    released

    Any IntelliJ-platform IDE. Needs Node.js on PATH.

    Every record of a GEDCOM file folded to one line each in WebStorm, listing the Simpsons and the Bouviers by name.
    • Find references

What each place does

One language service answers for all of them, so most of this table is the same in every column — a diagnostic reads the same wherever you meet it. Below that are the rows where the places part, each giving its own host abilities the others have no place for. An empty cell means it is not there — or, for a JetBrains IDE, that it was not verified rather than promised.

AbilityVS CodeObsidianJetBrainsBrowser
The same in every editor
Autocomplete that knows which tags are legal at this level, in this structure
Validation against the GEDCOM 5.5.1 and 7.0 specifications, as you type
Semantic highlighting of levels, tags and cross-references
Hover: what a tag means, and the record a cross-reference names
Go to definition from a cross-reference to its record
Quick fixes for broken references and invalid levels
Folding of records and nested structures
Clickable web links and links to files beside the document
Where they part
Find all references, with read and write highlightsin Find Usages
Safe cross-reference rename, as one undoable edit
An outline of the records in the document
Colour from the moment a file opens, before the server connects
GEDCOM highlighted and checked inside a fenced code blockin Markdownin notes
Indentation hints on nested lines
The photograph a record points at, shown where it is namedon hovercropped to the region
A note or photograph opened beside the document
A link from a note straight to a recordvault link or obsidian:// URL
A whole folder at once, written back in placeyour vaulta folder you grant

Embed it in your own editor

The same parser, schema and diagnostics are published as @domorium/codemirror for any CodeMirror 6 host, and as @domorium/validator for anything without an editor at all.

On npm
The editor

A reference implementation.

The browser editor runs the same parser, the same generated schema and the same diagnostics as every extension — with nothing to install and nothing uploaded. Open the example beside this text, or grant a folder and work on your own files in place.

  • Structure, cardinality and payload types, against the GEDCOM 5.5.1 and 7.0 specifications
  • Cross-references that name no record, with a quick fix that points them at one that exists
  • Levels that cannot follow the line above them
  • Dates naming a day their calendar does not have, such as 31 FEB
Open the editor
The Domorium editor in a browser with example.ged open, a broken cross-reference marked on line 23, and a problems panel reading “No FAM record carries @F0009@”.
Run the editor hereRuns on your machine either way.
Open source

Choose your editor. Keep your file.

Install the extension for the application you already work in, or open your .ged file in the browser. Nothing is converted to another format, and nothing leaves your machine.