Convert a Release Note for Slack and Teams
Admin ·
Before reusing a Markdown release note in a Slack app or Teams agent, choose the formatting rules for that message. Check what the draft retains so the recipient can still follow the note when links and images are reduced to labels.
Convert the release note to Slack API mrkdwn
Select Load example and Convert draft with Slack API mrkdwn selected. The first line is *Release 2.4*. The body uses single asterisks around Ready and underscores around review. The two tasks use checked and empty box characters next to the bullet.
The runbook link becomes the word runbook and the image becomes Image (Pipeline). Neither destination is included. The output is draft text for Slack’s API mrkdwn format.
Switch to Teams agent extended Markdown
Change Draft format to Teams agent extended Markdown and convert the same source. The first line is ## Release 2.4. The two tasks retain Markdown task markers, and the Arabic text and waving-hand emoji stay in source order.
Download the text draft and compare the two saved files. An agent applies this Teams format when its message activity uses textFormat extendedmarkdown. The format can render task boxes as read-only elements. A Teams chat editor or Adaptive Card has its own formatting rules.
Review literal characters, labels and omitted destinations
The draft uses fullwidth punctuation for at signs and recognizable bare URLs in prose. Raw HTML appears as escaped text. In the Slack draft, a literal formatting character such as an asterisk also uses a fullwidth version so it is distinguishable from a generated formatting mark.
If a destination needs a real link or mention, add it deliberately using that destination’s publishing controls. Reopen the saved text to verify the intended labels and formatting before reusing it. The ToolMellow preview displays text without contacting either platform.
Slack API mrkdwn formatting and automatic parsingMicrosoft Teams agent messages and extended Markdown
Common questions
Will tables look the same in both drafts?
Slack drafts use pipe-separated text rows. Teams agent drafts rebuild GFM table syntax and keep supported table alignment.
Does this tool produce a complete Slack or Teams API request?
It exports the message text. Your integration supplies the message fields, destination and formatting mode.
Sources
Put it into practice.
- Markdown to Slack and Teams
- Markdown Validator
- Markdown Heading Structure Auditor
- Markdown to HTML Converter