vust

Markdown · MediaWiki to MD

Convert MediaWiki to Markdown

Convert MediaWiki markup to clean Markdown. Handles `==H==` headings, `* lists`, `[[links]]`, `'''bold'''`, and `<ref>` footnotes. Ideal for wiki-to-static-site migrations.

Free · No signup · Instant

Free, no signup. Up to 1 MB per request.

Wiki markupLinks convertedMigration guide

This tool handles

  • ==Header== hierarchy up to ====H4====
  • '''bold''' and ''italic''
  • [[internal]] and [url external] links
  • <ref> footnotes → GFM [^N]

Not in scope

  • Wikitables ({| … |} syntax)
  • Infoboxes and complex templates
  • [[Category:…]] metadata tags

Try it live with the widget above — paste and see the output instantly. For the items under “Not in scope,” the migration guide below covers workarounds and when to use a different tool.

MediaWiki to Markdown examples

Paste real MediaWiki in the left column, see the Markdown output on the right.

Headers + bold

MediaWiki

==Overview== '''This''' is a paragraph.

Markdown

## Overview **This** is a paragraph.

Piped internal link

MediaWiki

[[Paris|City of Light]]

Markdown

[City of Light](Paris)

Reference footnote

MediaWiki

Text<ref>Source</ref>

Markdown

Text[^1] [^1]: Source

How MediaWiki-to-Markdown conversion works

01

Paste wiki markup — Paste your MediaWiki source into the input field.

02

Convert — Click Convert — headers, bold/italic, links, and references are mapped to Markdown.

03

Copy — Copy the Markdown or download as `.md`.

MediaWiki edge cases we handle

References collected at end

`<ref>` footnotes become sequential `[^N]` markers with definitions appended to the end of the document, following GFM footnote conventions.

Internal links need URL normalization

`[[Page Name]]` becomes `[Page Name](Page Name)`. If your destination uses slugified URLs (Hugo, Jekyll), run a post-conversion pass to normalize.

Templates become comments

`{{infobox}}` and similar templates become `<!-- template: name -->` comments preserving the name. You reconstruct the data manually or with custom components on the target.

Category tags need stripping

`[[Category:Physics]]` converts as a regular link. Strip these from the source before conversion or remove from the output.

Frequently asked questions

Process bigger files in @vustMarkdownBot

500-character free conversions in chat — pay-as-you-go for longer text.

Open Telegram bot
    MediaWiki to Markdown Converter — VUST