Markdown to PDF
v1.0REST API

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.

1

Ottieni la tua chiave API

Genera una chiave dalla tua dashboard nella sezione API Keys.

2

Scrivi Markdown

Qualsiasi Markdown valido è supportato — intestazioni, elenchi, blocchi di codice, tabelle, immagini.

3

Effettua la richiesta

Invia una richiesta POST con la tua chiave e il Markdown. Ricevi un PDF.

cURL
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.pdf

Autenticazione

apiDocs.authentication.description

Intestazione richiesta

IntestazioneValoreDescrizione
AuthorizationBearer mp_live_...La tua chiave API con prefisso Bearer
Content-Typeapplication/jsonRichiesto per tutte le richieste

apiDocs.authentication.keyFormat


POST /api/v1/convert

Converti Markdown in un documento PDF stilizzato.

Corpo della richiesta

markdownstringRichiesto

Il contenuto Markdown da convertire. Max 200.000 caratteri.

templateIdstringOpzionale

Template da usare. Uno di: clean, executive, resume, academic, legal, creative. Predefinito: clean.

filenamestringOpzionale

Nome del file PDF scaricato. Predefinito: document.pdf.

localestringOpzionale

Impostazione locale per il rendering. Uno di: en, es, fr, de, ja, zh-CN, ko, pt-BR, ar, ru, hi, it. Predefinito: en.

customTemplateIdUUIDOpzionale

UUID di un template personalizzato salvato. Il template deve appartenere all'utente della chiave API.

optionsobjectOpzionale

Opzioni di conversione: pageNumbers (boolean), bodyTextColor (hex), headingTextColor (hex), creativeAccent (slate|purple|blue|emerald|rose|amber).

Richieste di esempio

Python
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)
JavaScript
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

Clean

Design minimalista e moderno sans-serif con spaziatura pulita.

executive

Executive

Intestazioni con grazie con accenti blu marino professionali e numeri di pagina.

resume

Resume

Layout compatto a una colonna ottimizzato per curriculum.

academic

Academic

Intestazioni numerate, spaziatura generosa e corpo EB Garamond.

legal

Legal

Corpo con grazie a doppia spaziatura con formattazione citazioni formale.

creative

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.

StatoSignificatoAzione
200Successo — PDF restituitoScarica il PDF dal corpo della risposta.
400Corpo richiesta non validoVerifica che il tuo payload JSON corrisponda allo schema sopra.
401Chiave API non valida o mancanteVerifica che la tua chiave API sia attiva e formattata correttamente.
402Crediti API esauritiAcquista altri crediti dalla tua dashboard.
404Template personalizzato non trovatoVerifica che customTemplateId sia corretto e ti appartenga.
415Content-Type erratoImposta l'intestazione Content-Type su application/json.
422Opzioni di conversione non valideVerifica che il tuo oggetto options corrisponda alle specifiche.
429Limite di velocità raggiuntoAttendi e riprova. Controlla l'intestazione Retry-After.
500Errore del serverRiprova 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.

Free

$0

25 / month

Per test e valutazione.

Starter

$9

500 / month

Per privati e piccoli progetti.

Pro

$29

1,000 / month

Generazione prioritaria, supporto template personalizzati tramite API.

Serve di più? Contattaci per prezzi aziendali personalizzati.