Obsidian Wikilinks to Markdown

Convert Obsidian [[wikilinks]] and ![[embeds]] to standard Markdown links. Migration-ready.

Summary — What Free Obsidian Wikilinks to Markdown Does

What This Free Tool Is

Free Obsidian Wikilinks to Markdown Converter takes Obsidian notes with [[wikilinks]], [[Page|Alias]], [[Page#Heading]], and ![[image.png]] embeds and rewrites them as standard Markdown links and images. Migration-ready — configure slug format, space replacement, asset prefix, and embed handling to match your target system.

Privacy: This tool runs entirely in your browser. Your text is never uploaded, logged, or cached. Close the tab and it's gone. Verify in DevTools → Network: zero requests fire.

Why It's Free (And How We Keep It Free)

Leaving Obsidian for a static site, a blog, or another markdown editor shouldn't mean hand-rewriting every wikilink. The converter runs 100% in your browser, and your notes never leave your device.

Table of Use

At-a-Glance Reference

InputOutputTypical sizeSpeedLogin needed
Obsidian note (.md)Standard Markdown (.md)Any note size< 20 msNo

Obsidian Wikilinks to Markdown Features

Here's what this free tool does in detail — every feature is built to solve real problems, runs entirely in your browser, and is free forever.

Every Obsidian Wikilink Variant

Handles all five common forms: [[Page Name]], [[Page|Alias]], [[Page#Heading]], [[Page#Heading|Alias]], and [[Page^block-id]] block refs. The block ref suffix is stripped (standard Markdown has no equivalent); everything else is mapped to [text](page-slug.md) or [text](page-slug.md#heading).

If your notes also contain GFM alerts, check the Free Markdown Alert Generator to preview them.

Image and Note Embed Handling

Image embeds like ![[diagram.png]] become standard Markdown images ![diagram.png](diagram.png) with an optional asset prefix (useful if your destination stores images under assets/ or attachments/). Note embeds ![[Page]] have three strategies: link (convert to a regular link since standard MD has no transclusion), drop (remove entirely), or keep (leave raw for a custom renderer).

For converting HTML notes from other sources, use the Free HTML to Markdown tool.

Configurable Slug Format

Different static site generators expect different slug styles. Toggle lowercase slugs on or off, and pick hyphen or underscore for space replacement, so [[Page Name]] becomes page-name.md, Page_Name.md, Page-Name.md, or any combination. The .md extension is editable too (use .mdx for MDX sites or drop entirely for slug-only URLs).

Live Wikilink Stats

The stats row under the editor shows exactly what's in your note: total wikilinks, regular vs embeds, image embeds, count with aliases, and count with heading anchors. Useful for estimating migration scope before running a batch and for verifying that every link was picked up.

For deeper link analysis after conversion, use the Free Markdown Link Extractor.

How To Use Free Obsidian Wikilinks to Markdown

Step 1 — Paste the note

Drop in any Obsidian note with wikilinks and embeds.

Step 2 — Configure the options

Extension, slug casing, space replacement, asset prefix, and embed handling.

Step 3 — Copy or download

Save as .md and drop into your destination vault or site.

Who Can Use This Tool

Obsidian users migrating to Notion or Logseq

Export a vault and convert every note in minutes instead of hand-rewriting links.

Writers moving to a static site

Migrate from Obsidian to Hugo, Jekyll, 11ty, Astro, or any MD-based generator.

Researchers publishing notes

Turn private notes into public ones without breaking the link graph.

Bloggers rendering Obsidian posts

Convert Obsidian drafts into GFM for direct paste into a blog CMS.

PKM users experimenting with tools

Move content between Obsidian, Foam, Dendron, and back without losing structure.

Frequently Asked Questions

Is this Obsidian wikilinks converter free?

Yes. Free forever, no account required.

What wikilink syntaxes does it support?

Regular, aliased, heading-anchored, and block-ref wikilinks, plus image and note embeds.

How are images handled?

Image embeds become standard Markdown images with an optional asset path prefix.

Does it handle custom slug formats?

Yes. Toggle lowercase, pick hyphen vs underscore, and set the file extension.

Is my vault uploaded?

No. Runs 100% in your browser.

Related Free Markdown Tools