Free browser tool · zero cloud lock-in
Markdown-to-Wikilink Converter
Convert standard Markdown and CommonMark links to native Obsidian wikilinks without breaking external URLs.
Runs 100% locally in your browser. Convert standard CommonMark links into native Obsidian [[WikiLinks]] while strictly preserving external web URLs, heading anchors, image embeds, and code blocks.
| Line | Type | Original Link | Converted Wikilink | Status |
|---|---|---|---|---|
| 3 | Link | [Architecture Review Notes](meeting-records/2026-10-12-architecture-review.md) | [[meeting-records/2026-10-12-architecture-review|Architecture Review Notes]] | Converted |
| 6 | Link | [Local Storage](architecture/storage-engine.md) | [[architecture/storage-engine|Local Storage]] | Converted |
| 7 | Link | [FTS5 Search Indexes](architecture/storage-engine.md#sqlite-fts5-index) | [[architecture/storage-engine#sqlite-fts5-index|FTS5 Search Indexes]] | Converted |
| 8 | Link | [Whisper Models](whisper-models.md) | [[whisper-models|Whisper Models]] | Converted |
| 11 | Embed |  | ![[assets/audio-pipeline-flow.png|Architecture Flowchart]] | Converted |
| 15 | Link | [Apple ScreenCaptureKit](https://developer.apple.com/documentation/screencapturekit) | [Apple ScreenCaptureKit](https://developer.apple.com/documentation/screencapturekit) | Preserved (Web) |
| 16 | Link | [Security Inquiries](mailto:security@example.com) | [Security Inquiries](mailto:security@example.com) | Preserved (Web) |
| 17 | Link | [Public Benchmark](https://benchmarks.example.org/latency) | [Public Benchmark](https://benchmarks.example.org/latency) | Preserved (Web) |
| 29 | Link | [Action Items](task-matrix.md) | [[task-matrix|Action Items]] | Converted |
| 29 | Link | [Task Matrix](task-matrix.md) | [[task-matrix|Task Matrix]] | Converted |
Why Adopt Obsidian Wikilinks from Standard Markdown?
Standard CommonMark and GitHub Flavored Markdown (GFM) links require explicit relative paths and file extensions, such as [Project Plan](../../docs/planning/q4-plan.md). While universal for web static-site generators like Astro, Hugo, or Docusaurus, relative paths create significant friction inside personal knowledge management (PKM) tools like Obsidian:
- Graph Linking: Obsidian's internal graph indexing engine recognizes double-bracket
[[WikiLinks]]natively, creating bidirectional relationships in the interactive vault graph. - Automatic Rename Refactoring: When you rename a file inside an Obsidian vault, wikilinks to that note update automatically across thousands of notes. Hardcoded relative CommonMark links break immediately upon file movement.
- Visual Cleanliness: Writing
[[System Architecture]]is substantially faster and less error-prone than navigating relative folder trees like[System Architecture](../architecture/system-architecture.md).
Strict URL & Code Fence Shielding Rules
Naive regex search-and-replace scripts frequently corrupt markdown documents by turning external web links into broken wikilinks or destroying code examples. This browser tool enforces four immutable safety guarantees:
- Web Protocol Immunity: Any link beginning with
http://,https://,mailto:,ftp://, ordata:is strictly preserved as a standard CommonMark link. - Fenced Code Block Shielding: Lines between triple-backtick (
```) or triple-tilde (~~~) fences are treated as untouchable code payloads. Code examples demonstrating Markdown link syntax will never be corrupted. - Inline Backtick Protection: Inline backtick spans (such as
`[example](link.md)`) are recognized and skipped during parsing. - Piped Alias Normalization: If the link label matches the target note name (e.g.
[storage](storage.md)), the converter simplifies it to[[storage]]rather than creating redundant pipes like[[storage|storage]].
Recommended Migration Workflow
When migrating an existing repository or documentation vault into Obsidian:
- Copy your source document or export bundle into the input pane.
- Choose whether your vault configuration uses shortest-path notation or relative folder hierarchies in Obsidian > Settings > Files and links > New link format.
- Inspect the Link Mapping Ledger tab to verify that internal references were identified correctly and external documentation URLs remained intact.
- Download the converted
.mdfile directly to your Obsidian vault folder.
Related Local Note Tools
Explore other zero-network browser utilities for managing Markdown vaults and local documentation:
- Wikilink to Markdown Converter: Convert Obsidian [[WikiLinks]] back to portable CommonMark links for GitHub or web publishing.
- Markdown Table Builder: Design and format GFM tables with column alignment and formula injection protection.
- Markdown-to-CSV Extractor: Extract tabular rows from structured markdown notes into formula-safe spreadsheets.
- Frontmatter Batch Auditor: Audit YAML metadata consistency and schema conflicts across multiple notes.
- All Browser Tools: Full collection of local, private Markdown and note engineering utilities.
Frequently Asked Questions
Questions
Why convert standard Markdown links to Obsidian wikilinks?
Obsidian native wikilinks ([[Note Name]]) enable bidirectional graph indexing, automatic link updates when notes are renamed, and cleaner prose. When importing folders from GitHub, Docusaurus, or Hugo, converting relative [links](file.md) to wikilinks restores native graph navigation.
How does the converter handle external URLs like https:// or mailto: links?
External web links (https://, http://, mailto:, ftp:) are strictly shielded. The engine detects URI protocols and leaves them untouched as standard CommonMark links, ensuring you never end up with broken web links like [[https://google.com]].
Are code blocks and inline backticks protected from link conversion?
Yes. Fenced code blocks (``` and ~~~) and inline backtick code spans are parsed with strict state-machine boundaries. Markdown link syntax used inside code snippets, terminal commands, or documentation examples remains 100% unaltered.
How does shortest-path mode differ from preserving directory paths?
By default, the converter preserves relative subfolder paths (e.g., [[architecture/storage-engine|Storage Engine]]). If you enable shortest-path mode, the converter strips folder prefixes to leave only the note name ([[storage-engine|Storage Engine]]), matching Obsidian default shortest-path setting.
Does this tool upload or store my markdown files?
No. The conversion executes entirely inside your browser memory using local JavaScript string parsing. No note contents, links, or filenames are ever transmitted over the network or saved to remote databases.
Keep your notes private, portable, and fast
Write your daily records in clean, future-proof plain Markdown on your local disk with zero cloud lock-in.