Convert Jira Wiki to DocBook

Turn Jira Wiki, the wiki markup used in Jira comments and descriptions, into DocBook, the XML format for technical books and documentation toolchains. 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=jira and to=docbook, 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 Jira Wiki to DocBook 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.jira" \
  -F "from=jira" \
  -F "to=docbook" \
  -o output.xml

import requests

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

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

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

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

String body = "--" + boundary + "\r\n"
    + "Content-Disposition: form-data; name=\"file\"; filename=\"input.jira\"\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\njira\r\n"
    + "--" + boundary + "\r\nContent-Disposition: form-data; name=\"to\"\r\n\r\ndocbook\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.xml"), 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.jira"
    , partBS "from" "jira"
    , partBS "to" "docbook"
    ] req

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

About Jira Wiki

Jira wiki markup is the text formatting language used in Atlassian Jira issue descriptions and comments. Teams converting documentation or reports into Jira tickets use it to preserve headings, tables, and code blocks that Jira renders natively.

About DocBook

DocBook is an XML vocabulary for technical documentation, long established in enterprise and open-source publishing pipelines. Projects and publishers use it as a canonical source format from which HTML, PDF, and help systems are generated.

Frequently asked questions

How do I convert Jira Wiki to DocBook?

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

Is converting Jira Wiki to DocBook 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 Jira Wiki to DocBook 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.