Importing your world

The Import Hub at /import lets you bring content in from other worldbuilding tools. There are four importers: Markdown/Obsidian, WorldAnvil, LegendKeeper, and Kanka. The same basic flow applies to all of them.

Common import steps

  1. Go to /import and choose your source platform.
  2. Select a target world — either an existing world in your account or create a new one during the import.
  3. Upload your export file (format varies by source — see below).
  4. Review the import summary: entity count created, entity types detected, and any files that were skipped with a reason.
  5. Navigate to your world to see the imported entities. All imported entities default to GM Only visibility.
📝Note

Imported entities default to GM Only. You'll need to set visibility levels before any content appears to your players.

Markdown and Obsidian vaults

Accepts a single .md file or a .zip of .md files. The importer detects Obsidian vaults automatically by the presence of a .obsidian/ folder in the archive.

  • [[wikilinks]] in Obsidian notes become Skryrún wikilinks automatically
  • Entity types are inferred from frontmatter (type: npc) or from filenames when frontmatter is absent
  • The import summary lists which files were created as entities and which were skipped, along with the reason (missing title, unrecognized type, empty file, etc.)

Frontmatter the importer reads:

---
title: My NPC Name
type: npc
tags: villain, faction-leader
---

WorldAnvil

Accepts a WorldAnvil JSON export. In WorldAnvil, go to World Settings → Export and download the JSON file.

  • WorldAnvil article types are mapped to Skryrún entity types
  • Article body content is preserved
  • The import summary notes any content that couldn't be mapped to a Skryrún entity type

LegendKeeper

Accepts a LegendKeeper .lk project file or JSON export. In LegendKeeper, go to Settings → Export and download the file.

  • Pages and folders import as entities and entity groups
  • Tags carry over
  • Internal links are converted to Skryrún wikilinks where the target entity was also imported

Kanka

Accepts a Kanka campaign JSON export. In Kanka, go to Campaign → Export and download the file.

  • Kanka entity types map to Skryrún entity types
  • Relations between entities are imported as relationships
  • Entity notes are attached to the corresponding entity article

D&D 5e stat block import

Stat block import is separate from the main Import Hub. Access it from the Stat Blocks compendium in your world.

Paste raw stat block text or upload a .md file containing one or more stat blocks in standard 5e markdown format. The importer parses the stat block fields automatically and creates a stat block entity for each one. This works for both homebrew stat blocks you've written and exported content from tools that output stat block markdown.

💡Tip

If you have a large number of stat blocks, put them in a single file separated by a blank line between each block and upload the file rather than pasting them individually.

After importing

Once the import completes:

  • Check the import summary for skipped files and address them manually if needed
  • Set visibility levels on entities you want players to see
  • Review wikilinks — the importer converts links where it can, but some may need manual cleanup if the source used a non-standard format
  • Large imports may take a few minutes to process. Don't close the browser tab until the summary screen appears.
⚠️Warning

If you import into an existing world, new entities are created alongside your existing ones. The importer does not merge or overwrite existing entities, even if names match.