Convert Org Mode to AsciiDoc

Turn Org Mode, Emacs Org Mode, plain-text notes, documents, and literate programming, into AsciiDoc, the semantic authoring format behind many technical books and docs. 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=org and to=asciidoc, 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 Org Mode to AsciiDoc 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.org" \
  -F "from=org" \
  -F "to=asciidoc" \
  -o output.adoc

import requests

with open("input.org", "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": "org", "to": "asciidoc"},
    )

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

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

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.org"));

String body = "--" + boundary + "\r\n"
    + "Content-Disposition: form-data; name=\"file\"; filename=\"input.org\"\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\norg\r\n"
    + "--" + boundary + "\r\nContent-Disposition: form-data; name=\"to\"\r\n\r\nasciidoc\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.adoc"), 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.org"
    , partBS "from" "org"
    , partBS "to" "asciidoc"
    ] req

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

About Org Mode

Org Mode is the plain-text format of Emacs' organizational powerhouse, used for notes, task management, literate programming, and document authoring. Its outline-based structure, TODO states, and code blocks make it a favourite among programmers and academics who live in their editor.

About AsciiDoc

AsciiDoc is a semantic, plain-text authoring format used heavily for technical documentation and books. It powers toolchains like Asciidoctor and Antora, and publishers such as O'Reilly have used it for full-length technical books thanks to its precise section, admonition, and cross-reference semantics.

Frequently asked questions

How do I convert Org Mode to AsciiDoc?

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

Is converting Org Mode to AsciiDoc 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 Org Mode to AsciiDoc 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.