Convert HTML to Djot

Turn HTML, the markup language of the web, readable by every browser, into Djot, a light markup language designed as a cleaner successor to Markdown. 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=html and to=djot, 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 HTML to Djot 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.html" \
  -F "from=html" \
  -F "to=djot" \
  -o output.djot

import requests

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

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

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

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

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

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

About HTML

HTML is the markup language of the web, rendered natively by every browser on every device. It is both a publishing target (turn any document into a web page) and a source format (turn saved pages and web content into editable documents).

About Djot

Djot is a light markup language created by pandoc's author John MacFarlane as a cleaner, more parseable successor to Markdown. It fixes Markdown's ambiguities with a simpler spec, and is gaining adoption among people who care about predictable plain-text markup.

Frequently asked questions

How do I convert HTML to Djot?

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

Is converting HTML to Djot 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 HTML to Djot 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.