Formato de Markdown

​

Pipeline

1. Analizar Markdown para convertirlo en IR (markdownToIR) - texto sin formato más intervalos de estilo (negrita, cursiva, tachado, código, bloque de código, contenido oculto, cita en bloque, encabezado 1-6) e intervalos de enlace. Los desplazamientos son unidades de código UTF-16 para que los intervalos de estilo de Signal se ajusten directamente a su API. Las tablas se analizan solo cuando el canal habilita un modo de tabla.
2. Fragmentar la IR (chunkMarkdownIR / renderMarkdownIRChunksWithinLimit)
   • la división se realiza sobre el texto de la IR antes del renderizado, por lo que los estilos en línea y los enlaces se segmentan por fragmento en lugar de romperse al cruzar un límite.
3. Renderizar por canal (renderMarkdownWithMarkers) - un mapa de marcadores de estilo convierte los intervalos en el marcado nativo del canal.

​

Ejemplo de IR

Hola, **mundo**; consulta la [documentación](https://docs.openclaw.ai).

{
  "text": "Hola, mundo; consulta la documentación.",
  "styles": [{ "start": 6, "end": 11, "style": "bold" }],
  "links": [{ "start": 26, "end": 39, "href": "https://docs.openclaw.ai" }]
}

​

Tratamiento de tablas

channels:
  discord:
    markdown:
      tables: code
    accounts:
      work:
        markdown:
          tables: off

​

Reglas de fragmentación

• Los límites de fragmentos proceden de los adaptadores o la configuración del canal y se aplican al texto de la IR, no a la salida renderizada.
• Los bloques de código delimitados se conservan como un único bloque con un salto de línea final para que los canales rendericen correctamente el delimitador de cierre.
• Los prefijos de listas y citas en bloque forman parte del texto de la IR, por lo que la fragmentación nunca los divide por la mitad.
• Los estilos en línea nunca se dividen entre fragmentos; el renderizador vuelve a abrir un estilo abierto al principio del siguiente fragmento.

​

Política de enlaces

• Slack: [label](url) -> <url|label>; las URL simples permanecen sin cambios.
• Telegram: [label](url) -> <a href="url">label</a> (modo de análisis HTML).
• Signal: [label](url) -> label (url), salvo que la etiqueta ya coincida con la URL.

​

Contenido oculto

​

Añadir o actualizar un formateador de canal

1. Analizar una sola vez con markdownToIR(...), pasando las opciones adecuadas para el canal (autolink, headingStyle, blockquotePrefix, tableMode).
2. Renderizar con renderMarkdownWithMarkers(...) y un mapa de marcadores de estilo (o lógica personalizada de intervalos de estilo para transportes como Signal).
3. Fragmentar con chunkMarkdownIR(...) o renderMarkdownIRChunksWithinLimit(...) antes de renderizar cada fragmento.
4. Conectar el adaptador para que invoque el nuevo fragmentador y renderizador desde la ruta de envío saliente.
5. Probar con pruebas de formato y una prueba de entrega saliente si el canal utiliza fragmentos.

​

Errores habituales

• Los tokens entre paréntesis angulares de Slack (<@U123>, <#C123>, <https://...>) deben sobrevivir al escapado; el HTML sin procesar debe seguir escapándose de forma segura.
• El HTML de Telegram exige escapar el texto situado fuera de las etiquetas para evitar que se rompa el marcado.
• Los intervalos de estilo de Signal usan desplazamientos UTF-16, no desplazamientos de puntos de código.
• Conserva los saltos de línea finales en los bloques de código delimitados para que el marcador de cierre quede en su propia línea.

​

Contenido relacionado