Importing your world

⚔️ Weaver+

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.

Troubleshooting

The import completed but I'm missing entities. Check the import summary — skipped files are listed there with a reason. Common causes: missing title frontmatter, unrecognized entity type, or empty file body. Fix the source file and re-import; duplicates won't be created since the importer checks for name conflicts within the same import batch.

My Obsidian [[wikilinks]] aren't connecting to entities. Wikilinks only connect if both the source and target entities were imported in the same batch (or the target already existed in the world before import). If you imported files separately in multiple passes, the links from the first batch may not resolve to entities created in the second batch. Re-import the source files after all targets exist.

The import is taking a long time and nothing is happening. Large imports (500+ entities) can take several minutes. Keep the browser tab open and don't navigate away — the summary screen appears when processing finishes. If the tab has been open for more than 15 minutes without a result, contact support with your export file size.

My WorldAnvil import created entities with missing content. WorldAnvil's JSON export includes article bodies as HTML. The importer converts HTML to the Skryrún editor format, but complex formatting (tables, custom templates, embedded images) may not map cleanly. Review the imported entities and manually clean up any that have garbled content.

See also