Code Examples

const res = await fetch('https://docforge-api.vercel.app/api/md-to-html', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Api-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    markdown: `# Project Setup

Install dependencies:

\`\`\`bash
npm install
\`\`\`

## Features

- **Fast** conversion
- *Sanitized* output
- Code block support`
  })
});

const { html, meta } = await res.json();
console.log('Word count:', meta.wordCount);
console.log('Headings:', meta.headings);

import requests

response = requests.post(
    "https://docforge-api.vercel.app/api/md-to-html",
    headers={
        "Content-Type": "application/json",
        "X-Api-Key": "YOUR_API_KEY"
    },
    json={
        "markdown": "# Project Setup\n\nInstall dependencies:\n\n```bash\nnpm install\n```\n\n## Features\n\n- **Fast** conversion\n- *Sanitized* output\n- Code block support"
    }
)

data = response.json()
print("HTML:", data["html"][:100])
print("Headings:", data["meta"]["headings"])

// Step 1: Parse CSV to JSON
const res = await fetch('https://docforge-api.vercel.app/api/csv-to-json', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    csv: `product,units_sold,revenue
Widget Pro,1250,$62500
Gadget Plus,890,$44500
Mega Pack,340,$51000
Starter Kit,2100,$42000`
  })
});

const { data, meta } = await res.json();

// Step 2: Build an HTML table
const headers = meta.columns.map(c => `<th>${c}</th>`).join('');
const rows = data.map(row =>
  `<tr>${meta.columns.map(c => `<td>${row[c]}</td>`).join('')}</tr>`
).join('\n');

const table = `<table><thead><tr>${headers}</tr></thead><tbody>${rows}</tbody></table>`;
console.log(table);

import requests

response = requests.post(
    "https://docforge-api.vercel.app/api/csv-to-json",
    headers={"Content-Type": "application/json"},
    json={
        "csv": "product,units_sold,revenue\nWidget Pro,1250,$62500\nGadget Plus,890,$44500\nMega Pack,340,$51000\nStarter Kit,2100,$42000"
    }
)

data = response.json()
columns = data["meta"]["columns"]
rows = data["data"]

# Build HTML table
header = "".join(f"<th>{c}</th>" for c in columns)
body = "".join(
    f"<tr>{''.join(f'<td>{row[c]}</td>' for c in columns)}</tr>"
    for row in rows
)
print(f"<table><thead><tr>{header}</tr></thead><tbody>{body}</tbody></table>")

const BASE = 'https://docforge-api.vercel.app';

// Step 1: Convert JSON to CSV
const csvRes = await fetch(`${BASE}/api/json-to-csv`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    data: [
      { name: 'Alice', role: 'Engineer', status: 'Active' },
      { name: 'Bob', role: 'Designer', status: 'Active' },
      { name: 'Charlie', role: 'PM', status: 'On Leave' }
    ]
  })
});
const { csv } = await csvRes.json();

// Step 2: Build Markdown table and convert to HTML
const mdTable = `# Team Directory\n\n` + csv;
const htmlRes = await fetch(`${BASE}/api/md-to-html`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ markdown: mdTable })
});
const { html } = await htmlRes.json();
console.log(html);

import requests

BASE = "https://docforge-api.vercel.app"

# Step 1: Convert JSON to CSV
csv_res = requests.post(f"{BASE}/api/json-to-csv", json={
    "data": [
        {"name": "Alice", "role": "Engineer", "status": "Active"},
        {"name": "Bob", "role": "Designer", "status": "Active"},
        {"name": "Charlie", "role": "PM", "status": "On Leave"}
    ]
})
csv_text = csv_res.json()["csv"]

# Step 2: Build Markdown table and convert to HTML
md = f"# Team Directory\n\n{csv_text}"
html_res = requests.post(f"{BASE}/api/md-to-html", json={"markdown": md})
print(html_res.json()["html"])

import os, requests

API = "https://docforge-api.vercel.app/api/md-to-html"
DIR = "./docs"
HEADERS = {
    "Content-Type": "application/json",
    "X-Api-Key": os.environ["DOCFORGE_KEY"]
}

for filename in os.listdir(DIR):
    if not filename.endswith(".md"):
        continue

    with open(os.path.join(DIR, filename)) as f:
        md = f.read()

    res = requests.post(API, headers=HEADERS, json={"markdown": md})
    html = res.json()["html"]

    out_name = filename.replace(".md", ".html")
    with open(os.path.join(DIR, out_name), "w") as f:
        f.write(html)
    print(f"Converted {filename} -> {out_name}")

#!/bin/bash
# Convert all .md files in ./docs to HTML

for file in ./docs/*.md; do
  content=$(cat "$file" | jq -Rs .)
  outfile="${file%.md}.html"

  curl -s -X POST https://docforge-api.vercel.app/api/md-to-html \
    -H "Content-Type: application/json" \
    -H "X-Api-Key: $DOCFORGE_KEY" \
    -d "{\"markdown\": $content}" \
    | jq -r '.html' > "$outfile"

  echo "Converted $file -> $outfile"
done

// scripts/generate-docs.mjs — run in CI with: node scripts/generate-docs.mjs
import { readdir, readFile, writeFile, mkdir } from 'node:fs/promises';
import { join, basename } from 'node:path';

const API = 'https://docforge-api.vercel.app/api/md-to-html';
const SRC = './docs';
const OUT = './public';

await mkdir(OUT, { recursive: true });

const files = (await readdir(SRC)).filter(f => f.endsWith('.md'));

for (const file of files) {
  const md = await readFile(join(SRC, file), 'utf-8');
  const res = await fetch(API, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-Api-Key': process.env.DOCFORGE_KEY
    },
    body: JSON.stringify({ markdown: md })
  });
  const { html } = await res.json();
  await writeFile(join(OUT, basename(file, '.md') + '.html'), html);
}
console.log(`Generated ${files.length} HTML files`);

# scripts/generate_docs.py — run in CI with: python scripts/generate_docs.py
import os, requests
from pathlib import Path

API = "https://docforge-api.vercel.app/api/md-to-html"
SRC = Path("./docs")
OUT = Path("./public")
OUT.mkdir(exist_ok=True)

headers = {
    "Content-Type": "application/json",
    "X-Api-Key": os.environ["DOCFORGE_KEY"]
}

for md_file in SRC.glob("*.md"):
    res = requests.post(API, headers=headers, json={
        "markdown": md_file.read_text()
    })
    out_file = OUT / md_file.stem + ".html"
    out_file.write_text(res.json()["html"])

print(f"Generated {len(list(SRC.glob('*.md')))} HTML files")

// Convert a plain text email to formatted HTML
const plainText = `Dear Team,

Please review the Q1 budget proposal attached.

Key highlights:
- Total budget: $240,000
- Engineering: $150,000
- Marketing: $60,000
- Operations: $30,000

Deadline for feedback: March 15, 2026.

Best regards,
Finance Department`;

const res = await fetch('https://docforge-api.vercel.app/api/md-to-html', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ markdown: plainText })
});

const { html } = await res.json();
// html now contains <p> tags, a <ul> list, and proper formatting
document.getElementById('email-preview').innerHTML = html;

import requests

plain_text = """Dear Team,

Please review the Q1 budget proposal attached.

Key highlights:
- Total budget: $240,000
- Engineering: $150,000
- Marketing: $60,000
- Operations: $30,000

Deadline for feedback: March 15, 2026.

Best regards,
Finance Department"""

response = requests.post(
    "https://docforge-api.vercel.app/api/md-to-html",
    json={"markdown": plain_text}
)

html = response.json()["html"]
# Save to file for email template use
with open("email.html", "w") as f:
    f.write(html)
print("Saved formatted email to email.html")