API Markdown Converter para Desenvolvedores
Converta Markdown, PDF, Word e HTML de forma programática com um único endpoint REST. Renderização completa de equações LaTeX e diagramas Mermaid, hospedada e pronta para ser chamada em qualquer linguagem. Obtenha uma chave de API no RapidAPI e comece a converter em minutos.
Quickstart da API de Conversão de Markdown
Duas chamadas: envie um arquivo para obter um ID de tarefa e depois faça polling para a URL de download. Todos os endpoints seguem o mesmo padrão.
# 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. Envie uma conversão
Envie um upload de arquivo (source_file) ou uma URL pública (source_file_url). Você recebe de volta um task_id.
2. Faça polling do resultado
Faça polling em query-task com o task_id até o status ser completed; em seguida, baixe o arquivo a partir de to_url.
Endpoints da API de Markdown para PDF, Word e HTML
Todos os endpoints aceitam POST com multipart/form-data e retornam um task_id. Caminho base: /apix.
| Método | Endpoint | Descrição | Ferramenta online |
|---|---|---|---|
| POST | /apix/md-to-pdf | Converte Markdown para PDF, com renderização de LaTeX e Mermaid. | Testar online |
| POST | /apix/md-to-docx | Converte Markdown para um documento Word editável (.docx). | Testar online |
| POST | /apix/md-to-html | Converte Markdown para HTML limpo e semântico. | Testar online |
| POST | /apix/pdf-to-md | Extrai Markdown de um PDF, incluindo texto, tabelas e imagens. | Testar online |
| POST | /apix/docx-to-md | Converte um documento Word (.docx) para Markdown. | Testar online |
| POST | /apix/html-to-md | Converte uma página ou fragmento HTML para Markdown limpo. | Testar online |
| POST | /apix/query-task | Consulta uma tarefa pelo task_id e retorna a URL de download quando disponível. | — |
Como Funciona a API de Conversão Assíncrona
As conversões são executadas de forma assíncrona, portanto arquivos grandes nunca bloqueiam sua requisição.
Envio
Faça POST do seu arquivo Markdown, PDF, Word ou HTML — como upload ou URL pública — para o endpoint correspondente.
Receba um ID de tarefa
A API retorna imediatamente um task_id com status processing. Sem conexões de longa duração.
Polling e download
Chame query-task com o task_id. Quando o status for completed, baixe o arquivo a partir do to_url retornado.
O Que a API Markdown Converter Renderiza
De equações LaTeX a diagramas Mermaid, a API transforma Markdown complexo em PDF, Word e HTML sem perda de fidelidade.
Matemática em LaTeX
Equações LaTeX inline e em bloco são renderizadas fielmente nas saídas PDF e Word — ideal para documentos acadêmicos e técnicos.
Diagramas Mermaid
Fluxogramas, diagramas de sequência, gráficos de Gantt e diagramas de classe escritos em Mermaid são renderizados como gráficos reais.
Suporte Completo a GFM
Tabelas com pipes, listas de tarefas, blocos de código com destaque de sintaxe, tachado e links automáticos — tudo preservado.
Bidirecional
Converta de Markdown para PDF, Word e HTML — ou converta esses formatos de volta para Markdown limpo para controle de versão.
Casos de Uso da API de Conversão de Markdown
Desenvolvedores usam a API para gerar documentos automaticamente — em pipelines de build, funcionalidades de produto e processamentos em lote.
Pipelines de CI/CD
Gere release notes, relatórios ou artefatos PDF a partir de Markdown a cada build, sem precisar manter um headless browser.
Ferramentas de Documentação
Transforme documentações em Markdown em PDF ou Word para download por usuários, clientes e leitura offline — de forma automática.
Conversão em Lote
Processe grandes volumes de documentos no lado do servidor passando URLs públicas de arquivos e colete os resultados pelo ID de tarefa.
Preços da API Markdown Converter
A API é cobrada por uso através do RapidAPI, com um plano gratuito para começar e planos pagos que escalam conforme o seu consumo. Cobrança, chaves e limites de taxa são todos gerenciados na sua conta do RapidAPI.
Basic
30
requisições / mês
Pro
800
requisições / mês
+ $0.02 / request
Ultra
4,000
requisições / mês
+ $0.012 / request
Mega
12,000
requisições / mês
+ $0.008 / request
Cotas e preços são definidos no RapidAPI e podem ser alterados — consulte os planos ativos para informações atualizadas.
Ver Planos no RapidAPIFAQ de Integração com a API de Markdown
Tudo o que um desenvolvedor iniciante precisa saber para assinar, autenticar, enviar requisições e escolher um plano para a API de conversão de Markdown.
Como começo a usar a API de conversão de Markdown?
Crie uma conta gratuita no RapidAPI, abra a API Markdown Converter Pro no RapidAPI Hub e assine um plano — o plano Basic é gratuito. Após a assinatura, você já pode chamar qualquer endpoint imediatamente usando os exemplos de código acima.
Onde encontro minha chave de API?
Após assinar, o RapidAPI emite uma chave de API pessoal para a sua conta. Você a encontrará no seu painel do RapidAPI e na aba Code Snippets de qualquer endpoint. Envie-a em cada requisição como o header X-RapidAPI-Key, junto com o header X-RapidAPI-Host exibido ao lado.
Quais conversões a API suporta?
A API possui seis endpoints de conversão — Markdown para PDF, Word e HTML, mais o caminho inverso de PDF, Word e HTML de volta para Markdown — e um endpoint query-task para recuperar os resultados. A tabela de endpoints acima lista o caminho exato de cada um.
Quais parâmetros uma requisição de conversão precisa?
Cada endpoint de conversão recebe uma requisição multipart/form-data com um de dois campos: source_file para enviar o arquivo diretamente, ou source_file_url para apontar para um arquivo publicamente acessível. Use um ou outro — se ambos forem enviados, source_file tem precedência. Os arquivos podem ter até 50 MB e o tipo de arquivo deve corresponder ao endpoint; por exemplo, md-to-pdf espera um arquivo .md.
Como obtenho o arquivo convertido?
As conversões são executadas de forma assíncrona, portanto uma requisição bem-sucedida retorna um task_id em vez do arquivo em si. Passe esse task_id para o endpoint query-task e continue fazendo polling até o status ser completed; em seguida, baixe o arquivo finalizado a partir do to_url na resposta.
O que acontece quando uma conversão falha?
Se uma conversão não puder ser concluída, query-task retorna o status failed em vez de completed. As causas mais comuns são: um tipo de arquivo que não corresponde ao endpoint, um source_file_url que não está publicamente acessível, ou um arquivo maior que 50 MB. Corrija a entrada e envie a requisição novamente.
Qual plano de preços devo escolher?
Comece com o plano gratuito Basic para testar sua integração e migre para um plano pago conforme o volume mensal de requisições crescer. Cada plano inclui uma cota mensal de requisições e cobra um valor por requisição além dela — a tabela de preços acima mostra as faixas atuais. Cobrança e limites são gerenciados na sua conta do RapidAPI.
O que acontece com meus arquivos após a conversão?
Seus arquivos não são armazenados. Os documentos enviados e a saída convertida são processados temporariamente e removidos em seguida; os arquivos finalizados são servidos a partir de uma URL de download de curta duração, sem armazenamento de longo prazo.
Comece a Converter em Minutos
Assine no RapidAPI, pegue sua chave e faça sua primeira chamada de conversão hoje.
Começar no RapidAPI