MarkdownCo
API per sviluppatori

API Markdown Converter per sviluppatori

Converti Markdown, PDF, Word e HTML in modo programmatico con un singolo endpoint REST. Rendering completo di formule LaTeX e diagrammi Mermaid, ospitato e pronto all'uso da qualsiasi linguaggio. Ottieni una chiave API su RapidAPI e inizia a convertire in pochi minuti.

Quickstart dell'API di conversione Markdown

Due chiamate: invia un file per ottenere un task ID, poi effettua il polling per l'URL di download. Ogni endpoint segue lo stesso schema.

# 1. Submit a Markdown file for PDF conversion
curl -X POST "https://markdown-converter-pro.p.rapidapi.com/apix/md-to-pdf" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: markdown-converter-pro.p.rapidapi.com" \
  -F "source_file=@README.md"
# -> { "task_id": "550e8400-...", "status": "processing" }

# 2. Poll for the result until status is "completed"
curl -X POST "https://markdown-converter-pro.p.rapidapi.com/apix/query-task" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: markdown-converter-pro.p.rapidapi.com" \
  -d "task_id=550e8400-..."
# -> { "status": "completed", "to_url": "https://.../README.pdf" }

1. Invia una conversione

Carica un file (source_file) o fornisci l'URL pubblico di un file (source_file_url). Riceverai un task_id.

2. Esegui il polling del risultato

Interroga query-task con il task_id finché lo status non è completed, poi scarica il file da to_url.

Sostituisci YOUR_RAPIDAPI_KEY con la chiave presente nella tua dashboard RapidAPI. Anche il valore di X-RapidAPI-Host è indicato lì.

Endpoint dell'API Markdown in PDF, Word e HTML

Tutti gli endpoint accettano POST con multipart/form-data e restituiscono un task_id. Percorso base: /apix.

MetodoEndpointDescrizioneStrumento online
POST/apix/md-to-pdfConverti Markdown in PDF, con rendering di LaTeX e Mermaid.Prova online
POST/apix/md-to-docxConverti Markdown in un documento Word (.docx) modificabile.Prova online
POST/apix/md-to-htmlConverti Markdown in HTML semantico e pulito.Prova online
POST/apix/pdf-to-mdEstrai Markdown da un PDF, inclusi testo, tabelle e immagini.Prova online
POST/apix/docx-to-mdConverti un documento Word (.docx) in Markdown.Prova online
POST/apix/html-to-mdConverti una pagina o un frammento HTML in Markdown pulito.Prova online
POST/apix/query-taskInterroga un task tramite task_id e recupera l'URL di download quando è pronto.

Come funziona l'API di conversione asincrona

Le conversioni vengono eseguite in modo asincrono, così i file di grandi dimensioni non bloccano mai la tua richiesta.

Invia

Effettua una POST con il tuo file Markdown, PDF, Word o HTML — come upload o URL pubblico — verso l'endpoint corrispondente.

Ricevi un task ID

L'API restituisce immediatamente un task_id con status processing. Nessuna connessione tenuta aperta a lungo.

Polling e download

Chiama query-task con il task_id. Quando lo status è completed, scarica il file dall'to_url restituito nella risposta.

Cosa renderizza l'API Markdown Converter

Dalle equazioni LaTeX ai diagrammi Mermaid, l'API converte Markdown complesso in PDF, Word e HTML senza perdita di fedeltà.

Formule LaTeX

Le equazioni LaTeX inline e in blocco vengono renderizzate fedelmente nell'output PDF e Word — ideale per documenti accademici e tecnici.

Diagrammi Mermaid

Flowchart, diagrammi di sequenza, diagrammi di Gantt e diagrammi delle classi scritti in Mermaid vengono renderizzati come immagini vettoriali reali.

Supporto completo GFM

Tabelle con pipe, task list, blocchi di codice delimitati con syntax highlighting, testo barrato e auto-linking — tutto preservato.

Bidirezionale

Converti da Markdown in PDF, Word e HTML — o converti questi formati di ritorno in Markdown pulito per il controllo di versione.

Casi d'uso dell'API di conversione Markdown

Gli sviluppatori usano l'API per generare documenti automaticamente — nelle pipeline di build, nelle funzionalità di prodotto e nelle elaborazioni massive.

Pipeline CI/CD

Genera note di rilascio, report o artefatti PDF a partire da Markdown ad ogni build, senza dover mantenere un browser headless.

Strumenti per la documentazione

Trasforma la documentazione Markdown in PDF o Word scaricabile per utenti, clienti e lettura offline — in modo automatico.

Conversione batch

Elabora grandi insiemi di documenti lato server fornendo URL pubblici dei file, quindi raccoglie i risultati tramite task ID.

Prezzi dell'API Markdown Converter

L'API è a consumo tramite RapidAPI, con un piano gratuito per iniziare e piani a pagamento che crescono con il tuo utilizzo. Fatturazione, chiavi e limiti di frequenza sono tutti gestiti nel tuo account RapidAPI.

Basic

$0 / mese

30

richieste / mese

Pro

$7.90 / mese

800

richieste / mese

+ $0.02 / request

Consigliato

Ultra

$24.90 / mese

4,000

richieste / mese

+ $0.012 / request

Mega

$49.90 / mese

12,000

richieste / mese

+ $0.008 / request

Quote e prezzi sono impostati su RapidAPI e possono variare — controlla i piani attivi per i dettagli aggiornati.

Vedi i piani su RapidAPI

FAQ sull'integrazione dell'API Markdown

Tutto ciò che uno sviluppatore alle prime armi deve sapere per iscriversi, autenticarsi, inviare richieste e scegliere un piano per l'API di conversione Markdown.

Come inizio a usare l'API di conversione Markdown?

Crea un account RapidAPI gratuito, apri l'API Markdown Converter Pro nel RapidAPI Hub e abbonati a un piano — il piano Basic è gratuito. Una volta iscritto, puoi chiamare qualsiasi endpoint immediatamente usando gli esempi di codice qui sopra.

Dove trovo la mia chiave API?

Dopo l'iscrizione, RapidAPI genera una chiave API personale per il tuo account. La trovi nella tua dashboard RapidAPI e nella scheda Code Snippets di qualsiasi endpoint. Inviala ad ogni richiesta come header X-RapidAPI-Key, insieme all'header X-RapidAPI-Host indicato accanto ad essa.

Quali conversioni supporta l'API?

L'API dispone di sei endpoint di conversione — Markdown in PDF, Word e HTML, più la conversione inversa da PDF, Word e HTML di ritorno in Markdown — e di un endpoint query-task per recuperare i risultati. La tabella degli endpoint qui sopra riporta il percorso esatto per ciascuno.

Quali parametri richiede una richiesta di conversione?

Ogni endpoint di conversione accetta una richiesta multipart/form-data con uno di due campi: source_file per caricare direttamente un file, oppure source_file_url per puntare a un file accessibile pubblicamente. Usa l'uno o l'altro — se vengono inviati entrambi, source_file ha la precedenza. I file possono essere fino a 50 MB e il tipo di file deve corrispondere all'endpoint: md-to-pdf si aspetta un file .md.

Come ottengo il file convertito?

Le conversioni vengono eseguite in modo asincrono, quindi una richiesta andata a buon fine restituisce un task_id anziché il file stesso. Passa quel task_id all'endpoint query-task e continua a interrogarlo finché lo status non è completed, poi scarica il file completato dall'to_url presente nella risposta.

Cosa succede quando una conversione fallisce?

Se una conversione non può essere completata, query-task restituisce lo status failed invece di completed. Le cause più comuni sono un tipo di file che non corrisponde all'endpoint, un source_file_url non raggiungibile pubblicamente oppure un file superiore a 50 MB. Correggi l'input e invia nuovamente la richiesta.

Quale piano tariffario scelgo?

Inizia con il piano Basic gratuito per testare l'integrazione, poi passa a un piano a pagamento man mano che il volume mensile di richieste cresce. Ogni piano include una quota mensile di richieste e applica una tariffa ridotta per richiesta oltre tale soglia — la tabella dei prezzi qui sopra mostra i livelli attuali. Fatturazione e limiti sono gestiti nel tuo account RapidAPI.

Cosa succede ai miei file dopo la conversione?

I tuoi file non vengono conservati. I documenti caricati e l'output convertito vengono elaborati temporaneamente e rimossi al termine, e i file completati sono serviti tramite un URL di download a breve scadenza anziché archiviati a lungo termine.

Inizia a convertire in pochi minuti

Iscriviti su RapidAPI, ottieni la tua chiave e fai la tua prima chiamata di conversione oggi stesso.

Inizia su RapidAPI