Markdown to Word API: Developer Guide for Document Conversion

import requests
import os

# Configuration
API_URL = "https://www.markdown-to-word.online/api/convert"
API_KEY = os.environ.get("MD_TO_WORD_API_KEY", "YOUR_API_KEY")

# Read Markdown from a file
with open("README.md", "r", encoding="utf-8") as f:
    markdown_content = f.read()

# Make the API request
response = requests.post(
    API_URL,
    json={
        "markdown": markdown_content,
        "filename": "project-docs",
        "options": {
            "pageSize": "A4",
            "tableOfContents": True
        }
    },
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    timeout=30
)

# Handle the response
if response.status_code == 200:
    with open("project-docs.docx", "wb") as f:
        f.write(response.content)
    print("Conversion successful: project-docs.docx")
elif response.status_code == 429:
    retry_after = response.headers.get("Retry-After", 60)
    print(f"Rate limited. Retry after {retry_after} seconds.")
else:
    print(f"Error {response.status_code}: {response.json()}")

import { writeFileSync, readFileSync } from "node:fs";

const API_URL = "https://www.markdown-to-word.online/api/convert";
const API_KEY = process.env.MD_TO_WORD_API_KEY || "YOUR_API_KEY";

async function convertMarkdownToWord(markdownPath, outputPath) {
  const markdown = readFileSync(markdownPath, "utf-8");

  const response = await fetch(API_URL, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": `Bearer ${API_KEY}`
    },
    body: JSON.stringify({
      markdown,
      filename: "output-document",
      options: { pageSize: "A4" }
    })
  });

  if (!response.ok) {
    const error = await response.json();
    throw new Error(`API error ${response.status}: ${error.message}`);
  }

  const buffer = Buffer.from(await response.arrayBuffer());
  writeFileSync(outputPath, buffer);
  console.log(`Saved: ${outputPath}`);
}

// Usage
convertMarkdownToWord("./README.md", "./output.docx");

# Basic conversion
curl -X POST "https://www.markdown-to-word.online/api/convert" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"markdown": "# Hello World\n\nThis is a **test** document.", "filename": "test"}' \
  -o test.docx

# Convert from a file
curl -X POST "https://www.markdown-to-word.online/api/convert" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "$(jq -n --arg md "$(cat README.md)" '{markdown: $md, filename: "readme"}')" \
  -o readme.docx

# With advanced options
curl -X POST "https://www.markdown-to-word.online/api/convert" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "markdown": "# Report\n\n## Section 1\n\nContent here.",
    "filename": "report",
    "template": "corporate-default",
    "options": {"pageSize": "Letter", "tableOfContents": true}
  }' \
  -o report.docx