NoteMods

How to repair Craft links in Obsidian

Import the Markdown export first, then repair links that still use Craft addresses. As of October 2026, Obsidian documents Craft Markdown import and warns about its nonstandard link syntax. Craft Link Repair maps supported page identifiers to new local copies.

Updated · 3 ways compared · 2 sources

Background

Readable exported text can still contain links that open the source app. Metadata lets the repair tool distinguish a supported page target from a display label.

3 ways to do it

  1. Use the documented Craft export route

    Export Markdown from Craft on your desktop and follow Obsidian Markdown import instructions. Review the resulting links after moving the files.

    limits
    Obsidian warns that Craft uses nonstandard syntax for certain links. Importing readable text doesn't establish that those links resolve locally.

  2. Fix a few targets manually

    Open a source target, identify its local note and replace the link with an Obsidian internal link. This suits a small set of known pages.

    limits
    You must resolve ambiguous targets yourself. Manual editing doesn't provide the plugin report.

  3. Craft Link Repair from this site

    Keep unpacked Markdown, metadata and assets together inside the vault. Preview supported links, write copies and inspect unresolved URLs in the report.

    limits
    The free pass permits up to 10 new copies. Separate block targets and several other link forms remain outside the supported conversion.
    The Obsidian window shows a repaired Atlas note with local page links and its source note preserved.
    Open larger
    Install in Obsidian
    Directory pageSource on GitHub

    MIT · no telemetry · core features free

    All features of Craft Link Repair

Check the result before relying on it

  1. Unpack your export inside the vault, keeping Markdown, metadata and assets together.

  2. Run Preview repaired copies from the command palette.

  3. Enter the export folder path and select Preview links.

  4. Review the output paths and select Write copies.

  5. Open the report and follow links in sample repaired notes.

Common questions

Why retain the export folder after repair?

Pro copies in another folder can link back to source assets. The repair tool rebases simple relative paths rather than copying those files.

Will a date link create a journal entry?

The converter creates a wikilink to the date-note path. It doesn't create the destination date note.

Sources

Photo of Michael LipYou can now repair Craft links in Obsidian.

Obsidian rewards people who share. NoteMods is just me and a lot of coffee. If this guide saved you a fight with the syntax, buy me a cup.

Buy me a coffee · $5 via PayPalCard, any amount or monthlySponsor on GitHub monthly or one-time; $5 a month or $15 once also turns on Pro

Related guides

The plugin in this guide