How to import Vimwiki pages into Obsidian

As of October 2026, Obsidian's import guide lists Markdown imports but doesn't list Vimwiki conversion. Convert default pages by hand, or use Vimwiki Import to preview Markdown notes and mapped local links before writing.

Background

Keep your source pages until you've checked the converted notes. Vimwiki Import leaves those pages unchanged and reports syntax that needs review.

2 ways to do it

  1. Convert a few pages by hand

    For a few pages, copy their text into Markdown notes and replace source headings, tasks and code delimiters with Markdown syntax. Obsidian supports internal wikilinks, fenced code and unchecked or completed task lists. Check link targets against the note paths you choose.

    limits
    You handle conversion and link checking yourself. This route doesn't produce the plugin's source map or import report.
  2. Vimwiki Import from this site

    Place default .wiki pages in a vault folder and preview their conversion into a new destination. The free importer maps local links between selected pages and writes a report. Pro can map ISO diary names into a daily-note folder and combine saved unresolved-link warnings.

    limits
    Markdown and media modes aren't supported, and attachments aren't copied. Tables, anchors, directives and rich text can need manual edits.
    The import result shows a created Markdown note and two syntax warnings to review.
    Open larger

    MIT · no telemetry · core features free

    All features of Vimwiki Import

Preview and import default Vimwiki pages

  1. Back up your vault and place your source pages inside it.

  2. Run Vimwiki Import's Preview import command.

  3. Enter separate source and new destination paths, then select These files use default syntax.

  4. Select Preview and compare the converted text, mapped paths and warnings with your sources.

  5. Select Import and open the destination report.

  6. Compare a few converted notes with their sources before removing or moving source pages yourself.

Common questions

Why does a link still point to its old target?

The converter maps local targets only through the selected source pages. A missing target stays unchanged with a warning. Links to pages skipped during import can also need review.

Can I stop after checking the preview?

Select Cancel to close the preview without importing. Once you've selected Import, closing the dialog doesn't cancel writes that started.

Can the combined report confirm my later link fixes?

The Pro report reads saved import results rather than scanning your imported notes. Later edits aren't checked, and another import of the same source folder replaces its saved result.

Photo of Michael LipYou can now import Vimwiki pages into 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.