Documentazione API
Converti Markdown in PDF a livello di programmazione. La nostra REST API ti permette di generare PDF professionali e stilizzati da contenuto Markdown con una singola richiesta HTTP.
Avvio rapido
Genera un PDF in 30 secondi con un semplice comando curl.
Ottieni la tua chiave API
Genera una chiave dalla tua dashboard nella sezione API Keys.
Scrivi Markdown
Qualsiasi Markdown valido è supportato — intestazioni, elenchi, blocchi di codice, tabelle, immagini.
Effettua la richiesta
Invia una richiesta POST con la tua chiave e il Markdown. Ricevi un PDF.
curl -X POST https://markdowntopdfconverter.com/api/v1/convert \
-H "Authorization: Bearer mp_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"markdown": "# Hello World\n\nThis is a **test**.", "templateId": "clean"}' \
-o output.pdfAutenticazione
apiDocs.authentication.description
Intestazione richiesta
| Intestazione | Valore | Descrizione |
|---|---|---|
| Authorization | Bearer mp_live_... | La tua chiave API con prefisso Bearer |
| Content-Type | application/json | Richiesto per tutte le richieste |
apiDocs.authentication.keyFormat
POST /api/v1/convert
Converti Markdown in un documento PDF stilizzato.
Corpo della richiesta
markdownstringRichiestoIl contenuto Markdown da convertire. Max 200.000 caratteri.
templateIdstringOpzionaleTemplate da usare. Uno di: clean, executive, resume, academic, legal, creative. Predefinito: clean.
filenamestringOpzionaleNome del file PDF scaricato. Predefinito: document.pdf.
localestringOpzionaleImpostazione locale per il rendering. Uno di: en, es, fr, de, ja, zh-CN, ko, pt-BR, ar, ru, hi, it. Predefinito: en.
customTemplateIdUUIDOpzionaleUUID di un template personalizzato salvato. Il template deve appartenere all'utente della chiave API.
optionsobjectOpzionaleOpzioni di conversione: pageNumbers (boolean), bodyTextColor (hex), headingTextColor (hex), creativeAccent (slate|purple|blue|emerald|rose|amber).
Richieste di esempio
import requests
api_key = "mp_live_your_api_key_here"
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
}
payload = {
"markdown": "# Quarterly Report\n\n## Revenue\n\nRevenue grew **15%** this quarter.",
"templateId": "executive",
"options": {"pageNumbers": True}
}
response = requests.post(
"https://markdowntopdfconverter.com/api/v1/convert",
json=payload,
headers=headers
)
with open("report.pdf", "wb") as f:
f.write(response.content)const response = await fetch(
"https://markdowntopdfconverter.com/api/v1/convert",
{
method: "POST",
headers: {
Authorization: `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
markdown: "# Invoice\n\n**Amount:** $1,200\n\n| Item | Qty | Price |\n| --- | --- | --- |\n| Widget | 5 | $240 |",
templateId: "clean",
filename: "invoice",
}),
}
);
const blob = await response.blob();
const url = URL.createObjectURL(blob);
// Trigger download
const a = document.createElement("a");
a.href = url;
a.download = "invoice.pdf";
a.click();Template
Scegli tra sei template progettati professionalmente. Ogni template ha tipografia, spaziatura e schemi di colore distinti.
Clean
Design minimalista e moderno sans-serif con spaziatura pulita.
Executive
Intestazioni con grazie con accenti blu marino professionali e numeri di pagina.
Resume
Layout compatto a una colonna ottimizzato per curriculum.
Academic
Intestazioni numerate, spaziatura generosa e corpo EB Garamond.
Legal
Corpo con grazie a doppia spaziatura con formattazione citazioni formale.
Creative
Intestazioni DM Sans in grassetto con colori accento configurabili.
Codici di errore
Ogni risposta utilizza un codice di stato HTTP standard. Usalo per decidere come gestire il risultato.
| Stato | Significato | Azione |
|---|---|---|
| 200 | Successo — PDF restituito | Scarica il PDF dal corpo della risposta. |
| 400 | Corpo richiesta non valido | Verifica che il tuo payload JSON corrisponda allo schema sopra. |
| 401 | Chiave API non valida o mancante | Verifica che la tua chiave API sia attiva e formattata correttamente. |
| 402 | Crediti API esauriti | Acquista altri crediti dalla tua dashboard. |
| 404 | Template personalizzato non trovato | Verifica che customTemplateId sia corretto e ti appartenga. |
| 415 | Content-Type errato | Imposta l'intestazione Content-Type su application/json. |
| 422 | Opzioni di conversione non valide | Verifica che il tuo oggetto options corrisponda alle specifiche. |
| 429 | Limite di velocità raggiunto | Attendi e riprova. Controlla l'intestazione Retry-After. |
| 500 | Errore del server | Riprova con backoff esponenziale. Contatta il supporto se persiste. |
Prezzi API
Le chiamate API sono tracciate mensilmente. Ogni conversione riuscita conta per il limite mensile del tuo livello.
$0
25 / month
Per test e valutazione.
$9
500 / month
Per privati e piccoli progetti.
$29
1,000 / month
Generazione prioritaria, supporto template personalizzati tramite API.
Serve di più? Contattaci per prezzi aziendali personalizzati.