Convertidor
Convertidor de Markdown a HTML
Markdown a HTML es un convertidor del navegador que transforma CommonMark y GitHub Flavored Markdown en HTML saneado: incluye encabezados, tablas, listas de tareas y código delimitado. No se sube nada; el mismo renderizador funciona detrás de POST /v1/convert/markdown/html.
# markitdown-ai
Convert documents to clean Markdown.
## Features
- PDF, Word, and slides
- [x] Tables stay tables
- [ ] Mermaid coming later
## Install
```bash
pnpm add @markitdown-ai/sdk
```
## API
| Method | Path |
| --- | --- |
| POST | /v1/convert/{name} |
| GET | /v1/conversions/{id} |
Cómo se hace
Cómo convertir Markdown a HTML
Qué puedes pegar
- Cualquier Markdown: CommonMark más tablas, listas de tareas y tachado de GitHub Flavored Markdown
- El renderizado ocurre en tu navegador: no se sube nada mientras escribes
- No hace falta cuenta para previsualizar, copiar o descargar
- Sin límite de tamaño fijo; un documento muy grande queda limitado por la memoria de tu navegador
Qué revisar
- Encabezados y texto en línea — Los encabezados ATX y setext, el énfasis, los enlaces y las citas siguen CommonMark; cada encabezado recibe además un id apto para URL generado a partir de su texto.
- Tablas, listas de tareas y tachado — Las tablas de GitHub Flavored Markdown se convierten en elementos <table>, los elementos [ ] y [x] en casillas de verificación y ~~texto~~ en <del>.
- Marcado saneado — Las etiquetas <script> sin procesar, los manejadores de eventos en línea y los valores href o src fuera de http, https y mailto se eliminan antes de devolver el HTML.
- Código delimitado — Los bloques de código delimitado conservan su contenido y su etiqueta de lenguaje; la propia vista previa del navegador no aplica ningún tema de resaltado de sintaxis.
A dónde va el resultado
- Copia el HTML directamente desde la vista previa
- Descarga el archivo .html
- Automatízalo con POST /v1/convert/markdown/html y tu clave de API — 0 créditos
Por qué usarlo
Por qué usar este convertidor de Markdown a HTML
Un campo de CMS, un sitio estático y un editor de correo quieren marcado, no código Markdown. Este convertidor conserva las partes que aportan significado y elimina lo que haría inseguro el HTML sin procesar.
Se ejecuta en tu navegador
Pega Markdown y la vista previa HTML se actualiza localmente. No se sube nada y no hace falta cuenta para previsualizar, copiar o descargar.
CommonMark más GFM
Los encabezados, las listas, los enlaces, las citas y el código delimitado siguen CommonMark; las tablas, las listas de tareas y el tachado siguen GitHub Flavored Markdown.
Saneado por defecto
Las etiquetas script, los manejadores de eventos en línea y los esquemas href o src inseguros se eliminan, así que el HTML es seguro para pegar en una página que no controlas del todo.
Fragmento o documento completo
Copia solo el marcado renderizado para una página que ya tiene su propio diseño, o descarga un documento HTML completo con el estilo de la vista previa.
Anclas de encabezado
Cada encabezado recibe un id estable y apto para URL, generado igual que en la API, para que un índice o un enlace directo sigan funcionando después de publicar.
El mismo motor que la API
Esta vista previa y POST /v1/convert/markdown/html usan el mismo renderizador, así que el HTML que copias aquí coincide byte a byte con una llamada automatizada.
El problema
Por qué el Markdown sin procesar no puede ir directo a una página web
La sintaxis de Markdown no es HTML
Un campo de CMS, una plantilla de correo o un tema de sitio estático quieren marcado, no código Markdown, así que el texto sin procesar tiene que convertirse antes de poder darle estilo o incrustarlo.
Un analizador simple no cubre GFM
Las tablas, las listas de tareas y el tachado son extensiones de GitHub Flavored Markdown; un analizador que solo entiende CommonMark las renderiza como barras y virgulillas literales en vez de como estructura.
El Markdown no confiable puede llevar scripts
Markdown puede incrustar HTML sin procesar, incluidas etiquetas <script> y manejadores de eventos en línea, que deben eliminarse antes de que la salida sea segura para insertarla en una página que no controlas del todo.
Qué se conserva
Qué conserva este convertidor de Markdown a HTML
- Encabezados y texto en línea
- Los encabezados ATX y setext, el énfasis, los enlaces y las citas siguen CommonMark; cada encabezado recibe además un id apto para URL generado a partir de su texto.Source: CommonMark Spec
- Tablas, listas de tareas y tachado
- Las tablas de GitHub Flavored Markdown se convierten en elementos <table>, los elementos [ ] y [x] en casillas de verificación y ~~texto~~ en <del>.Source: GitHub Flavored Markdown Spec
- Marcado saneado
- Las etiquetas <script> sin procesar, los manejadores de eventos en línea y los valores href o src fuera de http, https y mailto se eliminan antes de devolver el HTML.Source: HTML Living Standard
- Código delimitado
- Los bloques de código delimitado conservan su contenido y su etiqueta de lenguaje; la propia vista previa del navegador no aplica ningún tema de resaltado de sintaxis.Source: CommonMark Spec
- HTML sin procesar en la fuente
- El Markdown que incrusta otras etiquetas HTML sin procesar pasa por el mismo saneador, así que una etiqueta incrustada nunca se trata como marcado de confianza.Source: HTML Living Standard
Extracto verificado de Markdown a HTML· https://markitdown.ai/blog/why-pdfs-break-llms
<h2 id="what-actually-goes-wrong">What actually goes wrong</h2><p>When teams pipe documents straight into an LLM or a retrieval index, a few failure modes show up again and again:</p><ul><li><strong>Reading order breaks.</strong> Multi-column layouts interleave. A two-column page becomes "line 1 left, line 1 right, line 2 left, line 2 right…", so a sentence a human reads top-to-bottom arrives at the model scrambled.</li><li><strong>Tables collapse.</strong> Copy-paste turns a table into a loose run of numbers. The relationship between a header and its cell — the entire point of a table — is gone.</li><li><strong>Headings disappear.</strong> The visual hierarchy (this is a section, this is a subsection) is encoded as font size and weight, not structure. Strip the styling and you get one undifferentiated wall of text.</li><li><strong>Noise creeps in.</strong> Page numbers, running headers, hyphenated line breaks, and stray ligatures end up inline, polluting prompts and embeddings alike.</li></ul><p>Read more in the <a href="https://markitdown.ai/blog/why-pdfs-break-llms">full article</a>.</p>Casos de uso
Casos de uso de la conversión de Markdown a HTML
Cuando un destino quiere marcado mientras el origen sigue en Markdown, este convertidor es el paso intermedio.
Documentación y sitios estáticos
Convierte un README o un artículo de Markdown de una base de conocimiento en el HTML que espera un generador de sitios estáticos o un campo de CMS.
Borradores de correo y boletines
Redacta un mensaje en Markdown, conviértelo a HTML y pega el fragmento en el editor de correo desde el que realmente envías.
Limpiar la respuesta de un LLM
ChatGPT, Claude y Gemini devuelven Markdown; conviértelo a HTML cuando el destino, ya sea un ticket o una página wiki, renderiza marcado en lugar de asteriscos sin procesar.
Desarrolladores que automatizan el renderizado
Llama al endpoint de renderizado desde un proceso que guarda Markdown pero sirve HTML, sin añadir una biblioteca de Markdown a cada servicio.
API
API de Markdown a HTML para desarrolladores
El renderizado se ejecuta de forma síncrona y cuesta 0 créditos; aun así cuenta para el límite de peticiones por minuto de tu plan. Envía Markdown como texto, o referencia un archivo .md guardado, a POST /v1/convert/markdown/html con tu clave de API; el HTML saneado vuelve en la misma respuesta.
Leer la guía de la APIcurl -X POST https://api.markitdown.ai/v1/convert/markdown/html \ -H "x-api-key: mdai_…" \ -H "Content-Type: application/json" \ -d '{ "text": "# Notes\n\nHello **world**." }'Guía
Documentación y sitios estáticos
La mayoría de las herramientas de documentación mantienen Markdown como fuente editable y generan HTML solo al compilar o al previsualizar. Este convertidor te permite comprobar ese paso de generación de forma aislada: pega el mismo Markdown que leerá el generador de tu sitio y confirma que los encabezados, las tablas y los bloques de código salen como espera tu tema antes de confirmar un cambio. También es útil cuando un campo de CMS acepta HTML pero tus redactores trabajan en Markdown: convierte una vez, pega el fragmento y sigue editando la fuente Markdown para la siguiente revisión en lugar de editar a mano el marcado generado.
- Conserva el archivo Markdown como tu fuente de verdad; trata el HTML como un artefacto de compilación.
- Compara la salida renderizada con el tema real de tu sitio, no solo con el estilo de la vista previa de esta página.
- Vuelve a ejecutar la conversión después de cada edición de la fuente en lugar de parchear a mano el HTML generado.
Saneado
Markdown puede incrustar HTML sin procesar, y ese HTML sin procesar puede incluir una etiqueta <script> o un manejador de eventos en línea como onclick. Antes de que este convertidor devuelva un resultado, ese marcado pasa por un saneador que elimina los elementos script, quita cualquier atributo que empiece por "on" y solo permite enlaces y fuentes de imagen http, https y mailto. Lo que sobrevive es la estructura semántica —encabezados, párrafos, listas, tablas, enlaces, imágenes y código—, no el estilo decorativo. El convertidor no inyecta una clase ni un archivo CSS en la salida de fragmento; la descarga de un documento completo añade el tema que ves en la vista previa para que el archivo se abra correctamente por sí solo.
Fragmento o página completa
Un fragmento es el marcado interior —los encabezados, los párrafos y las tablas— sin las etiquetas <html> o <head> que lo rodean. Pertenece a una página que ya define su propia estructura de documento y su estilo, como un campo de contenido de un CMS o un componente que renderiza elementos hijos. Un documento completo añade un doctype, un título y una pequeña hoja de estilos para que el archivo se pueda abrir directamente en un navegador o guardar por sí solo. Pegar un documento completo en un campo de contenido que espera un fragmento es un error habitual: el navegador puede que aún lo renderice, pero las etiquetas <html> y <head> anidadas no son válidas ahí y pueden confundir a las herramientas posteriores que esperan un fragmento.
Más convertidores de Markdown
- PDF → MarkdownTexto, tablas y escaneos
- Word → MarkdownDOCX con títulos y listas
- PPT → MarkdownTexto, notas y tablas de diapositivas
- Excel → MarkdownCada hoja como tabla
- Image → MarkdownOCR para escaneos y capturas
- HTML → MarkdownPega o sube HTML
- URL → MarkdownCualquier página web pública, limpia
- Markdown → TextTexto plano sin marcado
- Markdown → PDFImprime a PDF en local
Need it in your code? Use the developer API. Converting at scale? See plans and pricing.
FAQ
Preguntas sobre Markdown a HTML
¿Cómo funciona Markdown a HTML?
Pega o escribe Markdown y el convertidor renderiza HTML saneado localmente en tu navegador, con el mismo renderizador que POST /v1/convert/markdown/html. No se sube nada mientras escribes.
¿Markdown a HTML admite GitHub Flavored Markdown?
Sí. Las tablas, las listas de tareas y el tachado siguen la especificación de GitHub Flavored Markdown, junto con los encabezados, las listas, los enlaces y el código de CommonMark.
¿La salida HTML está saneada?
Sí. Las etiquetas script, los manejadores de eventos en línea y los esquemas href o src inseguros se eliminan, así que el HTML es seguro para pegar en una página que no controlas del todo.
¿Puedo obtener un documento HTML completo en vez de un fragmento?
Sí. Elige un documento completo con el estilo de la vista previa, o copia solo el fragmento para una página que ya tiene su propio diseño.
¿Necesito una cuenta para convertir Markdown a HTML?
No. La vista previa, la copia y la descarga funcionan sin iniciar sesión, porque el renderizado se ejecuta localmente en tu navegador.
¿Esto llama a la API mientras escribo?
No. Escribir se queda en local. La API solo se ejecuta cuando llamas directamente a POST /v1/convert/markdown/html, por ejemplo desde un script.
¿Hay un límite de tamaño para el Markdown que convierto?
No hay un límite de subida fijo porque no se sube nada; los límites prácticos dependen de la memoria de tu navegador para documentos muy grandes.
¿Puedo convertir Markdown a HTML desde código?
Sí. Envía tu Markdown como texto, o un archivo .md guardado, a /v1/convert/markdown/html con una clave de API. Cuesta 0 créditos. Consulta /developers.
Convierte Markdown a HTML donde quieras.
Pruébalo gratis: no hace falta registrarse.