Convert MediaWiki to Markdown

Turn MediaWiki, the wiki markup that powers Wikipedia and MediaWiki sites, into Markdown, the plain-text writing format used across READMEs, wikis, and static site generators. FileChanger runs the document conversion in one call, no local tooling to install.

In the browser

Upload a file and download the result, no pipeline required. Open the converter.

One API call

POST the file with from=mediawiki and to=markdown, get the converted bytes back. Jump to the code.

From an agent

FileChanger ships an MCP server, so agents can run this conversion themselves. See the docs for setup.

Convert MediaWiki to Markdown in code

The same call from any language: POST the file to /api/convert, the response body is the converted file.

curl -X POST https://filechanger.io/api/convert \
  -H "X-Api-Key: fc_your_api_key_here" \
  -F "file=@input.mediawiki" \
  -F "from=mediawiki" \
  -F "to=markdown" \
  -o output.md

import requests

with open("input.mediawiki", "rb") as f:
    response = requests.post(
        "https://filechanger.io/api/convert",
        headers={"X-Api-Key": "fc_your_api_key_here"},
        files={"file": f},
        data={"from": "mediawiki", "to": "markdown"},
    )

response.raise_for_status()
with open("output.md", "wb") as out:
    out.write(response.content)

const formData = new FormData();
formData.append("file", fileInput.files[0]);
formData.append("from", "mediawiki");
formData.append("to", "markdown");

const response = await fetch("https://filechanger.io/api/convert", {
  method: "POST",
  headers: { "X-Api-Key": "fc_your_api_key_here" },
  body: formData,
});

const output = await response.blob();

import java.net.http.HttpRequest.BodyPublishers;
import java.net.http.HttpResponse.BodyHandlers;
import java.nio.file.Path;

String boundary = "----FormBoundary" + System.currentTimeMillis();
byte[] fileBytes = java.nio.file.Files.readAllBytes(Path.of("input.mediawiki"));

String body = "--" + boundary + "\r\n"
    + "Content-Disposition: form-data; name=\"file\"; filename=\"input.mediawiki\"\r\n"
    + "Content-Type: application/octet-stream\r\n\r\n"
    + new String(fileBytes) + "\r\n"
    + "--" + boundary + "\r\nContent-Disposition: form-data; name=\"from\"\r\n\r\nmediawiki\r\n"
    + "--" + boundary + "\r\nContent-Disposition: form-data; name=\"to\"\r\n\r\nmarkdown\r\n"
    + "--" + boundary + "--";

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://filechanger.io/api/convert"))
    .header("X-Api-Key", "fc_your_api_key_here")
    .header("Content-Type", "multipart/form-data; boundary=" + boundary)
    .POST(BodyPublishers.ofString(body))
    .build();

HttpResponse<byte[]> response = client.send(
    request, BodyHandlers.ofByteArray());
java.nio.file.Files.write(Path.of("output.md"), response.body());

import Network.HTTP.Client
import Network.HTTP.Client.MultipartFormData
import qualified Data.ByteString.Lazy as BL

main :: IO ()
main = do
  manager <- newManager defaultManagerSettings
  initialReq <- parseRequest "POST https://filechanger.io/api/convert"
  let req = initialReq
        { requestHeaders = [("X-Api-Key", "fc_your_api_key_here")] }
  request <- formDataBody
    [ partFileSource "file" "input.mediawiki"
    , partBS "from" "mediawiki"
    , partBS "to" "markdown"
    ] req

  response <- httpLbs request manager
  BL.writeFile "output.md" (responseBody response)

About MediaWiki

MediaWiki markup is the wikitext syntax behind Wikipedia and every other MediaWiki-powered site. Editors, archivists, and companies running internal MediaWiki instances use it for collaboratively edited articles with templates, tables, and citations.

About Markdown

Markdown is the lightweight plain-text formatting syntax that took over the internet: READMEs, wikis, forums, note apps, and static site generators all speak it. Its appeal is that source files stay readable as plain text while still rendering to rich HTML.

Frequently asked questions

How do I convert MediaWiki to Markdown?

Upload your file in the browser converter and pick Markdown as the target, or POST it to /api/convert with from=mediawiki and to=markdown. The response body is the converted file.

Is converting MediaWiki to Markdown free?

Yes. The free tier includes 2 GB of conversions per month, metered on input size. See pricing for the paid tiers.

Is there an API for MediaWiki to Markdown conversion?

Yes, this whole conversion is one POST to /api/convert (the code examples above show it in five languages), plus an MCP server so AI agents can run it directly.