Free tool · works now

Wikilink to Markdown Converter

Convert Obsidian [[WikiLinks]] to standard Markdown links and back with full alias, anchor, and embed support.

Runs 100% in your browser. Convert Obsidian [[WikiLinks]] into portable Markdown links for GitHub, Hugo, and Astro, or convert standard links back to wikilinks with zero network calls.

1,050 chars · 28 lines
8 links converted
# System Architecture & Audio Pipeline

Prepared for the engineering review. See [Architecture Review Notes](Meeting Records/2026-10-12 Architecture Review.md) for attendee details.

## 1. Overview
The desktop core relies on [Local Storage](Local Storage.md) and [SQLite FTS5 Indexes](Storage Architecture.md#sqlite-fts5-index).
All audio transcription executes on-device via [Whisper Models](Whisper Models.md).

Refer to the pipeline diagram below:
![Audio Architecture Flowchart](diagrams/audio-pipeline-flow.png)

For cross-referencing:
- Core principles: [Architecture Principles](Architecture Principles.md)
- Security boundary: [Security & TCC Entitlements > Hardware Isolation](Security & TCC Entitlements.md#hardware-isolation)
- External references: [Apple ScreenCaptureKit Documentation](https://developer.apple.com/documentation/screencapturekit)

```python
# Configuration sample
# Links inside code blocks must remain untouched:
# import [[not_a_real_link]]
config_path = "vault/notes.md"
```

Inline code like `[[do_not_convert_this]]` must also be preserved.

## 2. Next Steps
Review the [Action Items](Task Matrix.md) and notify the team on Slack.
Link Conversion Audit LogLine-by-line mapping
LineOriginal LinkConverted LinkTarget File
3[[Meeting Records/2026-10-12 Architecture Review|Architecture Review Notes]][Architecture Review Notes](Meeting Records/2026-10-12 Architecture Review.md)Meeting Records/2026-10-12 Architecture Review
6[[Local Storage]][Local Storage](Local Storage.md)Local Storage
6[[Storage Architecture#SQLite FTS5 Index|SQLite FTS5 Indexes]][SQLite FTS5 Indexes](Storage Architecture.md#sqlite-fts5-index)Storage Architecture
7[[Whisper Models]][Whisper Models](Whisper Models.md)Whisper Models
10![[diagrams/audio-pipeline-flow.png|Audio Architecture Flowchart]]![Audio Architecture Flowchart](diagrams/audio-pipeline-flow.png)diagrams/audio-pipeline-flow.png
13[[Architecture Principles]][Architecture Principles](Architecture Principles.md)Architecture Principles
14[[Security & TCC Entitlements#Hardware Isolation]][Security & TCC Entitlements > Hardware Isolation](Security & TCC Entitlements.md#hardware-isolation)Security & TCC Entitlements
27[[Task Matrix|Action Items]][Action Items](Task Matrix.md)Task Matrix

Why Obsidian WikiLinks fail when published outside your vault

Internal linking is the superpower of modern personal knowledge management. In tools like Obsidian and Oyma, linking notes with double brackets ([[Note Name]]) allows seamless idea association without worrying about exact folder paths or manual file extensions.

However, WikiLinks are not part of the official CommonMark or GitHub Flavored Markdown (GFM) standards. When you export an Obsidian vault to GitHub, host your notes on static site generators like Astro, Hugo, or Docusaurus, or share raw Markdown files with colleagues using standard editors, those double-bracket links break completely. Instead of interactive navigation, readers see raw syntax brackets like [[Architecture Review]] that lead nowhere. This free tool converts your entire note collection into standard, portable Markdown links in seconds.

Anatomy of a WikiLink: Aliases, headings, and embeds

Obsidian’s internal link grammar encompasses several specialized syntax forms that require precise translation into CommonMark:

  • Piped Aliases ([[Target|Custom Label]]): Authors frequently refer to a concept using synonymous phrases. A piped alias specifies the destination note on the left and the visible link text on the right. Our converter maps this to standard Markdown link format: [Custom Label](Target.md).
  • Heading Anchors ([[Target#Section]]): Linking to specific subheadings requires appending a hash character to the target path. Our engine extracts the heading and formats it as an anchor target: [Target > Section](Target.md#section).
  • Embedded Media (![[image.png]]): An exclamation mark prefix indicates an embedded attachment or image. The converter translates this directly into standard Markdown image syntax: ![image.png](image.png).

Code fence and inline backtick immunity

A common defect of naive regular expression converters is mistakenly modifying text inside code snippets. Technical documentation frequently includes code blocks showcasing bracket syntax, array definitions, or configuration examples (e.g., Python lists or regex patterns like [[a-z]]).

Our converter features full structural parsing that isolates fenced code blocks (``` and ~~~) as well as inline backtick spans (`code`). Code examples remain 100% untouched while genuine prose links are safely transformed.

Publishing vaults to static site generators

If you publish notes to web frameworks such as Astro, Hugo, Jekyll, or MkDocs, standard Markdown links are essential for search engine optimization and accessible crawl paths. Standard links ensure search engine spiders can traverse your site hierarchy naturally.

This utility gives you granular control over output paths. You can choose whether to append the .md extension, preserve relative directory hierarchies, or percent-encode spaces to guarantee compatibility across diverse web servers and documentation frameworks.

Native WikiLinks and backlink navigation in Oyma

At Oyma, we believe you should never have to sacrifice link portability for convenience. Our macOS desktop app features native support for bidirectional WikiLinks and backlinks with real-time autocompletion, live hover previews, and automatic rename rewriting. When you rename a note, every inbound link updates automatically across your local vault. Explore our Obsidian vault guide or try our Markdown table of contents builder to keep your notes perfectly organized.

Questions

What is the difference between a WikiLink and a standard Markdown link?

A WikiLink uses double square brackets ([[Note Title]]), originating in wikis and popularized by personal knowledge management apps like Obsidian. A standard CommonMark link uses bracketed anchor text followed by a parenthesized relative file path ([Note Title](Note Title.md)).

How does the converter handle piped aliases like [[Note Title|Custom Label]]?

In WikiLink syntax, the pipe delimiter (|) separates the file destination from display text. Our converter extracts the target filename and sets the custom label as the Markdown anchor text: [Custom Label](Note Title.md).

How are heading anchors like [[Note#Section Name]] translated?

When linking to a specific section heading within a note, the converter appends a URL hash (#) to the destination path. By default, it slugifies heading titles to match standard GitHub and CommonMark anchor conventions (e.g., #section-name).

Can this tool convert standard Markdown links back into Obsidian WikiLinks?

Yes. Switching to reverse mode parses standard Markdown links ([Label](path/to/Note.md)), extracts the clean note name, restores piped aliases if the label differs from the filename, and generates native [[Note]] wikilinks. External web URLs (http/https) are left untouched.

Does this tool transmit my confidential notes or file links over the internet?

No. The entire conversion and link parsing engine executes 100% locally in your web browser. No notes, link references, or document contents are ever uploaded, logged, or sent to any remote server.

Want Obsidian links with native on-device audio capture?

Complete Obsidian vault compatibility, bidirectional backlinks, and private on-device meeting notes in Oyma.

tools wikilink to markdown downloadDownload for Mac

No account needed. Intel Mac build