Tous trois ont leur propre balisage, et aucun n’est du Markdown — voilà pourquoi un fichier .md collé arrive avec ses astérisques bien visibles.
Convertir du Markdown pour Confluence
Markdown vers le balisage wiki Jira, Markdown vers le mrkdwn de Slack
Confluence enregistre une page en XHTML avec ses propres macros, l’ancien balisage de Jira écrit le gras `*avec un astérisque*` et un titre `h2.`, et le mrkdwn de Slack n’a ni titres ni tableaux. Du Markdown collé comme texte dans l’un d’eux est lu comme leur balisage, ou pas lu du tout : astérisques doublés, dièses en début de ligne, tableau dessiné en barres verticales.
Confluence Cloud, Jira Cloud et le champ de message de Slack sont des éditeurs riches, et un éditeur riche garde la mise en forme qui arrive mise en forme. Copiez le document rendu plutôt que sa source, et titres, listes, liens, tableaux et blocs de code survivent au collage.
« Copier pour Confluence », « Copier pour Jira » et « Copier pour Slack » placent les deux versions dans le presse-papiers à la fois : un éditeur prend la version mise en forme, un simple champ de texte prend le balisage.
Une page écrite par un script, un pipeline ou un appel d’API a besoin du format propre à la plateforme. Pour Confluence, c’est le format de stockage, le `body.storage` de l’API REST — où un bloc délimité devient la macro de code et `> [!WARNING]` le panneau d’avertissement. Pour Jira, c’est le balisage wiki, que lisent le mode Texte de Data Center, la version 2 de l’API REST et les règles d’automatisation. Pour Slack, c’est le mrkdwn : le `text` d’un appel `chat.postMessage`, d’un webhook entrant ou d’une section Block Kit.
Une partie du Markdown n’a nulle part où aller. Slack n’a pas de tableaux, donc un tableau devient un bloc de code aux colonnes alignées. Aucun des trois ne dessine un diagramme Mermaid ni ne compose une formule : les deux arrivent comme leur source dans un bloc de code. Une image incorporée au document devrait d’abord être téléversée pour qu’ils l’affichent, elle est donc écrite comme sa description ; une image avec une adresse web reste une image.