Converter Tools
Markdown to MediaWiki Converter
Convert Markdown to MediaWiki wiki markup for Wikipedia, Fandom, and self-hosted wikis. Two-way conversion, runs in your browser, no signup.
Rewrite CommonMark or GitHub-Flavored Markdown into MediaWiki wiki markup for Wikipedia, Fandom, or any MediaWiki-powered wiki.
Headings become = h = through ====== h ======, **bold** becomes '''bold''', [label](url) becomes [url label], internal links use double brackets, GFM tables become {| wikitable |} blocks, and fenced code blocks become <syntaxhighlight lang=...> blocks.
Syntax mapping
Every construct, side by side.
| Construct | Markdown | MediaWiki |
|---|---|---|
| Bold | **bold** | '''bold''' |
| Italic | *italic* or _italic_ | ''italic'' |
| Bold + italic | ***both*** | '''''both''''' |
| Strike | ~~strike~~ | <s>strike</s> |
| Inline code | `code` | <code>code</code> |
| Code block | ```py ... ``` | <syntaxhighlight lang="py"> ... </syntaxhighlight> |
| Heading H1 | # Heading | = Heading = |
| Heading H6 | ###### Heading | ====== Heading ====== |
| External link | [label](url) | [url label] |
| Bare URL | https://x.test | https://x.test |
| Internal link | [label](wiki:Page) | [[Page|label]] |
| Image |  | [[File:X.jpg|alt]] |
| Quote | > line | <blockquote>line</blockquote> |
| Bullet | - item | * item |
| Nested bullet | - nested | ** nested |
| Numbered | 1. item | # item |
| Nested numbered | 1. nested | ## nested |
| HR | --- | ---- |
| Table | | a | b | | {| class="wikitable" ! a !! b |} |
MediaWiki quirks worth knowing
Things to remember when you paste into Wikipedia, Fandom, or a self-hosted MediaWiki.
- Bold uses three apostrophes. Pasting **bold** from GitHub leaves the asterisks as literal text on a MediaWiki page. The converter rewrites both ** and __ to '''.
- Bold + italic is five apostrophes. ''''' opens and closes a span that renders as both bold and italic at once. Six apostrophes does not work.
- Internal vs external links. A target like wiki:Page or a bare page name becomes [[Page]]. A scheme like https:// becomes [url label]with a space separating URL and label. Mixing the two breaks rendering.
- Images live in the File: namespace. Wikipedia renders an image only when the link starts with File:, Image:, or Media:. Bare external image URLs do not become inline images; they degrade to a numbered footnote link.
- Tables use the {| block. Cells separated by || run inline on one line; each new row starts with |-. The class="wikitable" attribute on the opening line is the de-facto default that gives borders and header styling.
- Code blocks use SyntaxHighlight.The extension ships with most MediaWiki installs; the <syntaxhighlight lang="..."> tag is the modern way to render syntax-highlighted code. A bare leading-space block is the legacy preformatted style.
- Headings start AND end with equal signs. The opening and closing equal sign count must match. = Foo = is H1; ====== Foo ====== is H6.
- Horizontal rules are four hyphens. Three hyphens render as literal text in MediaWiki.
- Templates and references pass through. The converter leaves {{Template}}and <ref>...</ref> tags untouched in either direction so nothing is lost.
Tips for editors
Drafting a Wikipedia article
Write the article in your preferred Markdown editor, paste it here, and copy the MediaWiki output straight into the Wikipedia edit window. Add {{Infobox}}, references, and categories on the wiki side; the converter leaves them in place on the next round trip.
Migrating a wiki to a static site
Switch to MediaWiki to Markdown. Paste the wiki source from Special:Export or the API, copy the Markdown output, and drop it into Hugo, MkDocs, Docusaurus, or any static-site generator.
Fandom and gaming wikis
Fandom (the former Wikia network) uses MediaWiki under the hood, so this converter works for any Fandom or Wikia wiki edit page. Game guides, lore pages, and infoboxes all map the same way.
Privacy
Both directions run entirely in your browser. Nothing is uploaded to a server, so drafts and unpublished article text never leave your device.
How to use
- Pick the direction: Markdown to MediaWiki to draft for a wiki, or MediaWiki to Markdown to migrate a wiki article into a Markdown document.
- Paste your source into the input panel on the left, or click a sample to load a worked example (article skeleton, release notes, or an image-and-table layout).
- Read the converted output on the right. Counts of characters and UTF-8 bytes appear under each panel so you can confirm the size is reasonable for the destination wiki or markdown file.
- Use Swap output into input to feed the result back as a new source. Round-tripping is lossless for the common constructs and a quick way to inspect the canonical form of either side.
- Click Copy MediaWiki markup or Copy Markdown to copy the result, then paste it straight into the Wikipedia edit window, a Fandom article, a self-hosted MediaWiki page, a README, a GitHub issue, or a static-site source file.
About this tool
Markdown to MediaWiki Converter rewrites a Markdown document into the wiki markup that Wikipedia, Fandom, Wikimedia Commons, and every MediaWiki-powered wiki accept, and rewrites MediaWiki source back into clean CommonMark Markdown. Both directions run entirely in your browser. The Markdown side recognises CommonMark and GitHub-Flavored Markdown: ATX and Setext headings, bold and italic with either asterisks or underscores, bold-italic, strikethrough, inline code, fenced code blocks with a language hint, blockquotes, ordered and unordered lists (with nesting), tables with header and body rows, horizontal rules, autolinks, reference-style links, and images. The output side maps each construct to its MediaWiki equivalent: equals-sign headings, triple-apostrophe bold, double-apostrophe italic, five-apostrophe bold-italic, single-bracket external links with a space separating URL and label, double-bracket internal links for wiki page references, File: image syntax for images, {| class="wikitable" tables with || cell separators, <syntaxhighlight lang=...> code blocks for the SyntaxHighlight extension that ships with most MediaWiki installs, and four-hyphen horizontal rules. Internal links are detected when the Markdown target is a bare page name or starts with the wiki: prefix; everything else stays an external link. Templates, references, magic words, and any other MediaWiki-specific construct without a Markdown equivalent pass through unchanged in either direction, so a round trip never silently drops content. The reverse direction parses MediaWiki tables (including header rows declared with !, attribute prefixes inside cells, and multi-line cells), unwraps SyntaxHighlight blocks back into fenced code blocks with the same language, restores Markdown emphasis from apostrophe runs, and normalises HTML blockquote, code, and strikethrough tags into their Markdown counterparts. Useful for editors moving a draft from a markdown editor into a Wikipedia or Fandom edit window, for technical writers migrating MediaWiki documentation to a static site (Hugo, MkDocs, Docusaurus, Astro), for game wiki contributors who keep notes in Obsidian or VS Code, and for anyone tired of manually translating apostrophes and brackets between two markup dialects. Sample documents cover an article skeleton, a release-notes page, and an image-and-table layout so you can sanity check the conversion before pasting into a live wiki.
Free to use. Works in your browser. No signup, no login.
Related tools
You may also like
Markdown to Jira Converter
Bidirectional Markdown and Jira wiki markup converter with full syntax support.
Open tool
ConverterMarkdown to Slack Converter
Two-way converter between Markdown and Slack's mrkdwn message format.
Open tool
ConverterMarkdown to HTML Converter
Convert Markdown to clean HTML with a live preview and copy button.
Open tool
ConverterHTML to Markdown Converter
Convert HTML to GFM Markdown with tables, code, and reference links.
Open tool
TextMarkdown to Plain Text
Remove Markdown formatting and get clean readable plain text.
Open tool
TextMarkdown Editor
Live markdown editor with toolbar, preview, table of contents, and .md or .html download.
Open tool