# HTML and Markdown to PDF API Convert HTML or Markdown to styled, print-ready PDFs. Powered by headless Chrome for pixel-perfect rendering. **Base URL:** `https://html-and-markdown-to-pdf1.p.rapidapi.com` --- ## Authentication All requests must include your RapidAPI credentials: ``` X-RapidAPI-Key: YOUR_RAPIDAPI_KEY X-RapidAPI-Host: html-and-markdown-to-pdf1.p.rapidapi.com ``` --- ## Endpoints ### Health Check Check if the API is online. ``` GET /health ``` **Response** ```json { "status": "ok" } ``` --- ### Convert HTML to PDF Submit an HTML string and receive a styled PDF file. ``` POST /api/v1/pdf/from-html ``` **Request Body** | Field | Type | Required | Description | |-------|------|----------|-------------| | `html` | string | ✅ | Full HTML string to convert | | `options` | object | ❌ | PDF layout options (see below) | **Options Object** | Field | Type | Default | Description | |-------|------|---------|-------------| | `pageSize` | string | `A4` | Page format: `A4`, `Letter`, `Legal`, `Tabloid`, `A3`, `A5` | | `orientation` | string | `portrait` | `portrait` or `landscape` | | `margin.top` | string | `20mm` | Top margin (e.g. `10mm`, `1in`) | | `margin.right` | string | `20mm` | Right margin | | `margin.bottom` | string | `20mm` | Bottom margin | | `margin.left` | string | `20mm` | Left margin | | `printBackground` | boolean | `true` | Include CSS background colors and images | | `displayHeaderFooter` | boolean | `false` | Show header/footer templates | | `headerTemplate` | string | `""` | HTML string for page header | | `footerTemplate` | string | `""` | HTML string for page footer | **Example Request** ```json { "html": "<html><body>

Invoice #1042

Amount due: $99.00

</body></html>", "options": { "pageSize": "A4", "orientation": "portrait", "margin": { "top": "20mm", "right": "20mm", "bottom": "20mm", "left": "20mm" }, "printBackground": true } } ``` **Example — Node.js** ```javascript const axios = require('axios'); const fs = require('fs'); const response = await axios.post( 'https://html-and-markdown-to-pdf1.p.rapidapi.com/api/v1/pdf/from-html', { html: '

Hello World

', options: { pageSize: 'A4' } }, { headers: { 'Content-Type': 'application/json', 'X-RapidAPI-Key': 'YOUR_RAPIDAPI_KEY', 'X-RapidAPI-Host': 'html-and-markdown-to-pdf1.p.rapidapi.com' }, responseType: 'arraybuffer' } ); fs.writeFileSync('output.pdf', response.data); ``` **Example — Python** ```python import requests response = requests.post( 'https://html-and-markdown-to-pdf1.p.rapidapi.com/api/v1/pdf/from-html', json={ 'html': '

Hello World

', 'options': { 'pageSize': 'A4' } }, headers={ 'Content-Type': 'application/json', 'X-RapidAPI-Key': 'YOUR_RAPIDAPI_KEY', 'X-RapidAPI-Host': 'html-and-markdown-to-pdf1.p.rapidapi.com' } ) with open('output.pdf', 'wb') as f: f.write(response.content) ``` **Response:** Binary PDF file with `Content-Type: application/pdf` --- ### Convert Markdown to PDF Submit a GitHub-flavored Markdown string and receive a styled PDF. ``` POST /api/v1/pdf/from-markdown ``` **Request Body** | Field | Type | Required | Description | |-------|------|----------|-------------| | `markdown` | string | ✅ | Markdown string to convert (GFM supported) | | `options` | object | ❌ | PDF layout options (same as HTML endpoint) | **Supported Markdown Features** - Headings (`#`, `##`, `###`, etc.) - **Bold**, *italic*, ~~strikethrough~~ - Tables (GFM) - Fenced code blocks - Blockquotes - Ordered and unordered lists - Images and links **Example Request** ```json { "markdown": "# Report\n\n## Summary\n\nThis is **markdown** converted to PDF.", "options": { "pageSize": "A4", "orientation": "portrait" } } ``` **Example — Node.js** ```javascript const response = await axios.post( 'https://html-and-markdown-to-pdf1.p.rapidapi.com/api/v1/pdf/from-markdown', { markdown: '# Hello\n\nThis is **bold**.', options: { pageSize: 'Letter' } }, { headers: { 'X-RapidAPI-Key': 'YOUR_RAPIDAPI_KEY', 'X-RapidAPI-Host': 'html-and-markdown-to-pdf1.p.rapidapi.com' }, responseType: 'arraybuffer' } ); fs.writeFileSync('output.pdf', response.data); ``` **Response:** Binary PDF file with `Content-Type: application/pdf` --- ## Error Responses | Status | Meaning | |--------|---------| | `400` | Missing or invalid input | | `403` | Invalid or missing API key | | `429` | Rate limit exceeded | | `500` | Server error during PDF generation | --- ## Tips & Best Practices ### Handling binary response The API returns raw PDF bytes. Use `responseType: 'arraybuffer'` in axios or `.content` in Python requests. ### CSS support Full Chrome CSS is supported in the HTML endpoint. Use `printBackground: true` for background colors. ### Page breaks ```html <style> .page-break { page-break-after: always; } </style> ``` ### Headers and footers ```json { "displayHeaderFooter": true, "headerTemplate": "

My Doc

", "footerTemplate": "

Page of

" } ```