Free Tool

Obsidian Wikilink to Markdown Converter

GitHub, static site generators, and most markdown apps do not understand[[wikilinks]]. Paste a note here to turn them into portable [text](path.md) links, or switch direction to convert back for your vault. Everything runs in your browser — nothing is uploaded.

or drop a file onto the input area below

Direction

Convert Obsidian wikilinks to standard markdown links, or the reverse for vault import.

Wikilink → MarkdownMarkdown → Wikilink

Link targets

Add .md extensionEncode link paths

Note embeds

For ![[Some note]] (not image files).

LinkKeep wikilinkRemove

Image path prefix (optional)

Prepended to ![[image.png]] targets only, e.g.assets.

Markdown note

Paste a note or drop a .md file. Output updates as you type.

Converted markdown

Copy this into GitHub, a static site, or back into Obsidian.

How to convert wikilinks to markdown links

Paste markdown, upload a .md file, or drop one onto the input area.
Keep Wikilink → Markdown selected (default). Adjust.md extension, path encoding, and note-embed handling if you are publishing outside Obsidian.
Copy or download the converted note. UseClean Markdown Formatter afterward if you also need list, callout, or spacing cleanup.

Supported link syntax

[[Note]] → [Note](Note.md)
[[Note|alias]] → [alias](Note.md)
[[Folder/Note#Heading]] keeps the heading in the URL fragment.
[[Note#^blockId]] keeps Obsidian block references in the fragment.
![[image.png]] becomes a standard markdown image; optional path prefix for your assets folder.
![[Some note]] (note embeds) can become a link, stay a wikilink, or be removed.

Links inside fenced code blocks, inline code, and YAML frontmatter are left unchanged. Nested [[ inside link text is not supported.

Markdown → wikilink mode

Switch direction to convert local [text](note.md) links back into [[note]] or [[note|text]]. External URLs,mailto:, and obsidian: links are skipped.

FAQ

Do wikilinks work on GitHub?

No. GitHub renders standard markdown only, so [[Note]]appears as plain text. Converting to [Note](Note.md) gives you a working link in a repository.

Is my note uploaded?

No. Conversion runs entirely in your browser. Your vault text never leaves your device.

Can I convert my whole vault at once?

This tool converts one note at a time. For vault-wide link format changes inside Obsidian, use the Link Converter community plugin.

Notes

Note text is limited to 1 MB.
Copy to clipboard requires a secure connection (HTTPS) and browser permission.