Cómo pegar Markdown en Confluence, Jira o Slack

Los tres tienen su propio marcado y ninguno es Markdown; por eso un archivo .md pegado llega con los asteriscos a la vista.

Convertir Markdown para Confluence

Markdown a marcado wiki de Jira, Markdown a mrkdwn de Slack

Por qué sale mal

Confluence guarda una página como XHTML con macros propias, el marcado antiguo de Jira escribe la negrita `*con un asterisco*` y un encabezado como `h2.`, y el mrkdwn de Slack no tiene encabezados ni tablas. El Markdown pegado como texto en cualquiera de ellos se lee como su marcado, o no se lee: asteriscos dobles, almohadillas al principio de las líneas, una tabla dibujada con barras.

En un editor: pega el documento, no el marcado

Confluence Cloud, Jira Cloud y el cuadro de mensajes de Slack son editores enriquecidos, y un editor enriquecido conserva el formato que llega con formato. Copia el documento renderizado en lugar de su fuente y los encabezados, listas, enlaces, tablas y bloques de código sobreviven al pegado.

«Copiar para Confluence», «Copiar para Jira» y «Copiar para Slack» ponen las dos versiones en el portapapeles a la vez: un editor toma la que tiene formato y un campo de texto simple toma el marcado.

En todo lo que no es un editor: el marcado

Una página que escribe un script, un pipeline o una llamada a una API necesita el formato propio de la plataforma. En Confluence es el formato de almacenamiento, el `body.storage` de la API REST, donde un bloque delimitado se convierte en la macro de código y `> [!WARNING]` en el panel de advertencia. En Jira es el marcado wiki, que leen el modo Texto de Data Center, la versión 2 de la API REST y las reglas de automatización. En Slack es mrkdwn: el `text` de una llamada `chat.postMessage`, de un webhook entrante o de una sección de Block Kit.

Lo que no pasa

Parte del Markdown no tiene adónde ir. Slack no tiene tablas, así que una tabla se convierte en un bloque de código con las columnas rellenadas. Ninguno de los tres dibuja un diagrama Mermaid ni compone una fórmula, así que ambos llegan como su código fuente en un bloque de código. Una imagen incrustada en el documento tendría que subirse antes de que la muestren, así que se escribe su descripción; una imagen con dirección web sigue siendo una imagen.