Convertir y previsualizar Markdown

Panel
Documentación
API

convierte su Markdown en HTML y muestra una vista previa en directo, ideal para redactar READMEs, documentación o artículos

¿Qué es Markdown?

Markdown es un lenguaje de marcado ligero creado por John Gruber en 2004. Permite redactar texto con formato utilizando una sintaxis sencilla y legible en su estado bruto, que luego se convierte en HTML.

Esta herramienta utiliza la especificación GFM (GitHub Flavored Markdown), la variante más extendida, que añade compatibilidad con tablas, casillas de verificación, bloques de código con resaltado de sintaxis y enlaces automáticos.

La vista previa de la derecha se actualiza en tiempo real mientras escribe. El botón Enviar genera el código HTML correspondiente, que puede copiar o descargar.

Sintaxis básica de Markdown

Markdown	Resultado
`# Título 1`	Título <h1>
`## Título 2`	Título <h2>
`negrita`	negrita
`cursiva`	cursiva
`código en línea`	`código en línea`
```php ... ```	Bloque de código PHP
`[texto](url)`	Hipervínculo
`![alt](url)`	Imagen
`- elemento`	Lista no ordenada
`1. elemento`	Lista ordenada
`> cita`	Blockquote
`---`	Separador horizontal

Casos de uso habituales

README de GitHub: redactar la documentación de un proyecto de código abierto.
Documentación técnica: escribir guías, wikis o páginas de documentación (MkDocs, Docusaurus, Hugo).
Artículos de blog: la mayoría de los CMS (Jekyll, Ghost, Contentful) aceptan Markdown.
Comentarios e incidencias: GitHub, GitLab, Jira, Notion y Slack admiten todos GFM.
Correos con formato: convertir Markdown en HTML para integrarlo en un correo HTML.
Notas y diapositivas: Obsidian, Notion, Marp y Reveal.js utilizan Markdown.

Preguntas frecuentes

¿Cuál es la diferencia entre Markdown estándar y GFM?

El Markdown estándar (CommonMark) cubre los elementos básicos: títulos, listas, enlaces, código. GFM (GitHub Flavored Markdown) añade las tablas, las listas de tareas (- [ ] elemento), el código delimitado con lenguaje (```php), las menciones y los enlaces automáticos. Esta herramienta utiliza GFM mediante la biblioteca league/commonmark.

¿Es seguro el HTML generado?

Sí. El convertidor está configurado para eliminar las etiquetas HTML brutas (html_input: strip) y bloquear los enlaces no seguros, lo que impide los ataques XSS. El HTML producido es apto para integrarse en una página web existente.

¿Puedo incluir HTML en mi Markdown?

Por motivos de seguridad, el HTML bruto insertado en el Markdown se elimina durante la conversión. Si necesita un renderizado HTML personalizado, redacte directamente el HTML de destino.

¿Cuál es el tamaño máximo del documento?

No hay un límite estricto en el lado del servidor para esta herramienta. Para documentos muy largos (más de unos pocos miles de líneas), la vista previa en tiempo real puede ralentizarse según su navegador.

Ejemplo de solicitud

curl -X POST https://cdrn.fr/api/v1/tools/markdown-formatter/execute \
  -H "Content-Type: application/json" \
  -d '{"input":"..."}'

Esquema de entrada

Campo	Tipo	Obligatorio	Por defecto
`input`	text		–

Puntos de acceso

GET https://cdrn.fr/api/v1/tools - lista todas las herramientas disponibles
GET https://cdrn.fr/api/v1/tools/markdown-formatter - recupera el esquema de esta herramienta
POST https://cdrn.fr/api/v1/tools/markdown-formatter/execute - ejecuta esta herramienta con un payload JSON