Saltar al contenido
Totalmente local

Convertidor de callouts Markdown

Convertir bloques de callouts y admoniciones entre sintaxis de GitHub, Obsidian, Docusaurus y MkDocs.

Entrada

Convertidor de callouts Markdown

Los bloques de callouts—los recuadros de "Nota", "Consejo" o "Advertencia" en READMEs y sitios de documentación—se escriben de manera diferente en cada plataforma. GitHub usa alertas de cita de bloque como `> [!NOTE]`, Obsidian extiende esa sintaxis con títulos personalizados y flechas desplegables, Docusaurus envuelve el contenido en cercas `:::tip`, y MkDocs (y Material for MkDocs) utiliza bloques `!!! note` indentados con `???` para los desplegables. Mover documentación entre herramientas generalmente significa reescribir cada callout manualmente—esta herramienta los convierte automáticamente.

Elige una notación de origen y destino en el panel de opciones, luego pega contenido escrito en el formato de origen. Cada callout reconocido se analiza y reescribe en la sintaxis de destino; cualquier otra cosa en la entrada—párrafos, encabezados, otro Markdown—pasa sin cambios. "Mantener título personalizado del bloque" conserva un encabezado como el de Obsidian `> [!info] Heads up` cuando el destino lo permite (GitHub no tiene sintaxis de título, así que un título conservado se convierte en una línea en negrita al inicio). "Mantener estado plegable/desplegable" preserva los marcadores de pliegue `+`/`-` de Obsidian y la sintaxis `???`/`???+` de MkDocs donde el destino tiene un equivalente; GitHub y Docusaurus no tienen callouts desplegables, así que la opción no tiene efecto ahí. "Normalizar tipo de bloque" mapea nombres menos comunes (importante, precaución, éxito, pregunta…) en los cinco tipos que todos los formatos comparten: nota, consejo, advertencia, peligro e información.

El cuerpo de cada callout se conserva exactamente como está escrito, incluyendo listas anidadas, formato en línea, enlaces y bloques de código cercados—esos son solo líneas ordinarias dentro del bloque. Múltiples callouts en un documento se convierten en una sola pasada, y los finales de línea Windows y Unix se manejan de la misma manera.

Todo se ejecuta localmente en tu navegador; tu documentación nunca se carga en ningún lugar. Copia el resultado, descárgalo como archivo .txt, o envía la salida de vuelta a la entrada para encadenar otra conversión.

Preguntas frecuentes

¿Qué tipos de callout reconoce?
Cualquier nombre de tipo en la sintaxis de origen—nota, consejo, advertencia, peligro, información y los específicos de la plataforma como importante o faq. Activa "Normalizar tipo de bloque" para mapear los menos comunes en los cinco tipos que todos los formatos comparten.
¿Qué sucede con un título personalizado cuando el formato de destino no lo tiene?
GitHub no tiene sintaxis de título, así que un título conservado se añade como una línea en negrita dentro del bloque en lugar de ser eliminado.
¿Se admiten callouts desplegables?
Sí, entre Obsidian ("+"/"-" después del tipo) y MkDocs ("???"/"???+"). GitHub y Docusaurus no tienen sintaxis desplegable, así que el estado se descarta al convertir a cualquiera de estos.
¿Sobrevivirán las listas y bloques de código dentro de un callout a la conversión?
Sí. Todo dentro del cuerpo de un callout se lleva tal cual—listas anidadas, formato en línea y bloques de código cercados incluidos.
¿Se carga mi documento en algún lugar?
No. La conversión se ejecuta completamente en tu navegador—tu texto nunca sale de tu dispositivo.