Skip to content

Support Obsidian Import (wikilinks + asset references) #788

@perber

Description

@perber

Summary

Add support for importing Obsidian-style Markdown notes in a way that preserves:

  • WikiLinks between notes
  • embedded asset references such as images, PDFs, audio, or video
  • relative relationships between notes and files inside a vault

This should make it easier to migrate an existing Obsidian vault into LeafWiki without manually rewriting links.

Problem

At the moment, importing Markdown content from Obsidian is limited because Obsidian uses conventions that differ from LeafWiki's internal link handling, especially:

  • [[Note Name]] style WikiLinks
  • ![[image.png]] style embedded assets
  • file and page names that may later be normalized differently
  • vault-relative paths and references across folders

A simple file import is not enough here, because links need to be migrated consistently across the full note set.

Expected behavior

When importing an Obsidian vault, LeafWiki should:

  • detect Obsidian WikiLinks like [[Page Name]]
  • convert them into valid LeafWiki/Markdown links
  • detect embedded file references like ![[image.png]]
  • import/copy referenced assets where possible
  • update the resulting links so they point to the correct imported page or asset
  • handle notes and assets across folders in a vault-aware way

Example

Obsidian source:

---
date: 2023-07-18
tags:
  - internal
  - newsletter
author: Jane Doe
---

# July Newsletter

See also [[Company Timeline]]

![[happy_ppl_202306.jpg]]

Expected result after import:

  • frontmatter remains intact where supported
  • [[Company Timeline]] resolves to the correct imported page
  • ![[happy_ppl_202306.jpg]] resolves to the imported asset
  • links remain valid even if LeafWiki normalizes page names differently

Metadata

Metadata

Assignees

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions