MarkdownCo
API para desarrolladores

API de Markdown Converter para desarrolladores

Convierte Markdown, PDF, Word y HTML mediante programación con un único endpoint REST. Renderizado completo de fórmulas LaTeX y diagramas Mermaid, alojado y listo para invocar desde cualquier lenguaje. Obtén tu clave en RapidAPI y empieza a convertir en minutos.

Inicio rápido con la API de conversión de Markdown

Dos llamadas: envía un archivo para obtener un ID de tarea y luego consulta el estado para descargar el resultado. Todos los endpoints siguen el mismo patrón.

# 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. Envía una conversión

Sube un archivo (source_file) o indica una URL pública (source_file_url). La respuesta incluye un task_id.

2. Consulta el resultado

Consulta query-task con el task_id hasta que el estado sea completed y descarga desde to_url.

Reemplaza YOUR_RAPIDAPI_KEY con la clave de tu panel de RapidAPI. El valor de X-RapidAPI-Host también aparece allí.

Endpoints de la API Markdown a PDF, Word y HTML

Todos los endpoints aceptan POST con multipart/form-data y devuelven un task_id. Ruta base: /apix.

MétodoEndpointDescripciónHerramienta online
POST/apix/md-to-pdfConvierte Markdown a PDF con renderizado de LaTeX y Mermaid.Probar online
POST/apix/md-to-docxConvierte Markdown a un documento Word editable (.docx).Probar online
POST/apix/md-to-htmlConvierte Markdown a HTML limpio y semántico.Probar online
POST/apix/pdf-to-mdExtrae Markdown de un PDF, incluyendo texto, tablas e imágenes.Probar online
POST/apix/docx-to-mdConvierte un documento Word (.docx) a Markdown.Probar online
POST/apix/html-to-mdConvierte una página o fragmento HTML a Markdown limpio.Probar online
POST/apix/query-taskConsulta una tarea por task_id y obtiene la URL de descarga cuando está lista.

Cómo funciona la API de conversión asíncrona

Las conversiones se ejecutan de forma asíncrona, por lo que los archivos grandes nunca bloquean tu solicitud.

Envío

Envía mediante POST tu archivo Markdown, PDF, Word o HTML —como subida directa o URL pública— al endpoint correspondiente.

Recibe un ID de tarea

La API devuelve inmediatamente un task_id con estado processing. Sin conexiones de larga duración.

Consulta y descarga

Llama a query-task con el task_id. Cuando el estado sea completed, descarga el archivo desde la to_url devuelta.

Qué renderiza la API de Markdown Converter

Desde ecuaciones LaTeX hasta diagramas Mermaid, la API transforma Markdown complejo en PDF, Word y HTML sin perder fidelidad.

Fórmulas LaTeX

Las ecuaciones LaTeX en línea y en bloque se renderizan fielmente en la salida PDF y Word —ideal para documentos académicos y técnicos.

Diagramas Mermaid

Diagramas de flujo, de secuencia, de Gantt y de clases escritos en Mermaid se renderizan como gráficos reales.

Soporte completo de GFM

Tablas con pipes, listas de tareas, bloques de código delimitados con resaltado de sintaxis, tachado y autoenlaces — todo preservado.

Bidireccional

Convierte de Markdown a PDF, Word y HTML —o convierte esos formatos de vuelta a Markdown limpio para control de versiones.

Casos de uso de la API de conversión de Markdown

Los desarrolladores usan la API para generar documentos automáticamente: en pipelines de build, funcionalidades de producto y tareas en lote.

Pipelines CI/CD

Genera notas de versión, informes o artefactos PDF a partir de Markdown en cada build, sin necesidad de mantener un navegador headless.

Herramientas de documentación

Convierte documentación en Markdown a PDF o Word descargable para usuarios, clientes y lectura sin conexión —de forma automática.

Conversión en lote

Procesa grandes conjuntos de documentos en el servidor pasando URLs públicas y recoge los resultados por ID de tarea.

Precios de la API Markdown Converter

La API se factura a través de RapidAPI con un plan gratuito para empezar y planes de pago que escalan según tu uso. La facturación, las claves y los límites de uso se gestionan desde tu cuenta de RapidAPI.

Basic

$0 / mes

30

solicitudes / mes

Pro

$7.90 / mes

800

solicitudes / mes

+ $0.02 / request

Recomendado

Ultra

$24.90 / mes

4,000

solicitudes / mes

+ $0.012 / request

Mega

$49.90 / mes

12,000

solicitudes / mes

+ $0.008 / request

Las cuotas y los precios se establecen en RapidAPI y pueden cambiar — consulta los planes actuales para ver los detalles vigentes.

Ver planes en RapidAPI

FAQ sobre integración con la API de Markdown

Todo lo que un desarrollador primerizo necesita para suscribirse, autenticarse, enviar solicitudes y elegir un plan para la API de conversión de Markdown.

¿Cómo empiezo a usar la API de conversión de Markdown?

Crea una cuenta gratuita en RapidAPI, abre la API Markdown Converter Pro en el RapidAPI Hub y suscríbete a un plan —el plan Basic es gratuito. Una vez suscrito, puedes llamar a cualquier endpoint de inmediato usando los ejemplos de código anteriores.

¿Dónde encuentro mi clave de API?

Tras suscribirte, RapidAPI genera una clave de API personal para tu cuenta. La encontrarás en tu panel de RapidAPI y en la pestaña Code Snippets de cualquier endpoint. Envíala en cada solicitud como la cabecera X-RapidAPI-Key, junto con la cabecera X-RapidAPI-Host que aparece a su lado.

¿Qué conversiones admite la API?

La API cuenta con seis endpoints de conversión —Markdown a PDF, Word y HTML, más la dirección inversa desde PDF, Word y HTML de vuelta a Markdown— y un endpoint query-task para recuperar los resultados. La tabla de endpoints anterior indica la ruta exacta de cada uno.

¿Qué parámetros necesita una solicitud de conversión?

Cada endpoint de conversión acepta una solicitud multipart/form-data con uno de dos campos: source_file para subir un archivo directamente, o source_file_url para apuntar a un archivo accesible públicamente. Usa uno u otro —si se envían ambos, source_file tiene prioridad. Los archivos pueden tener hasta 50 MB y el tipo de archivo debe coincidir con el endpoint; por ejemplo, md-to-pdf espera un archivo .md.

¿Cómo obtengo el archivo convertido?

Las conversiones se ejecutan de forma asíncrona, por lo que una solicitud exitosa devuelve un task_id en lugar del archivo en sí. Pasa ese task_id al endpoint query-task y sigue consultando hasta que el estado sea completed; luego descarga el archivo resultante desde la to_url de la respuesta.

¿Qué ocurre cuando falla una conversión?

Si una conversión no puede completarse, query-task devuelve el estado failed en lugar de completed. Las causas más comunes son un tipo de archivo que no coincide con el endpoint, una source_file_url que no es accesible públicamente, o un archivo de más de 50 MB. Corrige la entrada y vuelve a enviar la solicitud.

¿Qué plan de precios debo elegir?

Empieza con el plan gratuito Basic para probar tu integración y pasa a un plan de pago a medida que crezca tu volumen mensual de solicitudes. Cada plan incluye una cuota mensual de solicitudes y cobra una pequeña tarifa por solicitud adicional —la tabla de precios anterior muestra los niveles actuales. La facturación y los límites se gestionan en tu cuenta de RapidAPI.

¿Qué sucede con mis archivos tras la conversión?

Tus archivos no se conservan. Los documentos subidos y la salida convertida se procesan de forma temporal y se eliminan posteriormente; los archivos finalizados se sirven desde una URL de descarga de corta duración en lugar de almacenarse a largo plazo.

Empieza a convertir en minutos

Suscríbete en RapidAPI, obtén tu clave y realiza tu primera llamada de conversión hoy mismo.

Comenzar en RapidAPI