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

Go to /import and choose your source platform.
Select a target world — either an existing world in your account or create a new one during the import.
Upload your export file (format varies by source — see below).
Review the import summary: entity count created, entity types detected, and any files that were skipped with a reason.
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 or ZIP export. In WorldAnvil, go to World Settings → Export and download either format — both are supported.

The importer detects multiple WorldAnvil export formats automatically — older exports that use entityClass and newer ones that use the article type field are both supported.

Category mapping:

WorldAnvil type	Skryrún entity type
person / people	NPC
location	Location
organization	Faction
item / artifact	Item
prose / journal	Article
condition / spell / technology	Custom

Article body content is preserved
The import summary notes any content that couldn't be mapped to a known entity type
Large exports with 1,000+ articles may take several minutes — keep the tab open until the summary screen appears

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 shows "no articles found". Note the exact export settings you used and report it via the bug reporter — include your WorldAnvil export format (JSON or ZIP) and approximate article count.

My WorldAnvil import created entities in the wrong category. The importer maps WorldAnvil article types to Skryrún entity types using the entityClass field (older exports) or the article type field (newer exports). If your export uses a custom category that isn't in the mapping table, those articles import as generic Articles. You can bulk-edit entity types in your world after import.

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.