Opens in a new tab

Sharp Markdown: Markdown for Confluence and Jira

Write and edit Confluence pages and Jira issues in Markdown. Mentions, macros and other items that Markdown can’t show stay safe. Two apps, one for each product, coming to the Atlassian Marketplace.

Read the documentationSupportThe Sharp Markdown macro on a Confluence page: a task list, a warning panel, highlighted code and a Mermaid diagram

What is Sharp Markdown?

Sharp Markdown brings Markdown to Confluence and Jira: in Confluence as a macro on the page and for editing whole pages, and in Jira for issue descriptions and comments. Markdown is plain text with simple marks for formatting, such as **bold** and # Heading.

There are two apps with the same Markdown engine. Sharp Markdown for Confluence adds a Markdown macro, editing pages in Markdown, and copying, exporting and importing pages. Sharp Markdown for Jira adds three actions to the issue menu: edit the description in Markdown, comment in Markdown and copy the issue as Markdown. Install the one for the product you use, or both.

No data leaves Atlassian. The apps run on Atlassian’s Forge platform, have no external connections and store nothing of their own: the Markdown stays in your Confluence page or Jira issue.

How do I use Markdown in Confluence and Jira?

The apps use GitHub Flavored Markdown, described at github.github.com/gfm.

Confluence: the Markdown macro

  1. Edit a page, type /Sharp Markdown and choose Sharp Markdown.
  2. Write Markdown on the left. The preview on the right updates while you type. On a narrow screen, switch between Write and Preview.
  3. The toolbar adds headings, bold, italic, links, code, lists, task lists, tables and note panels.
  4. Select Save and publish the page. To change the Markdown later, edit the page, select the macro and choose the edit (pencil) button.

Confluence: pages in Markdown

These actions are in the ••• menu of a page, under Apps.

  • Edit in Markdown opens the whole page as Markdown with a preview. Saving makes a new version of the page, and page history keeps the earlier versions.
  • Copy as Markdown copies the page as Markdown, for example for an AI chat.
  • Export as Markdown downloads the page, or the page and its child pages. A single page without images downloads as a .md file, anything else as a .zip.
  • Import Markdown turns Markdown files, a folder or a .zip into pages under the open page. You see the page tree, the attachments and the notes before anything is created.

Jira

These actions are in the ••• menu of an issue.

  • Edit description in Markdown opens the description as Markdown with a preview. If someone else changes the issue while you edit, the save stops.
  • Comment in Markdown saves Markdown as a normal Jira comment with headings, tables, task lists and code. It suits answers pasted from AI tools.
  • Copy issue as Markdown copies the summary, key fields, description and comments, or downloads them as a .md file.
  • When you paste Jira wiki markup into the editor, for example an old description from the issue history, the app offers to convert it to Markdown.

Features

Markdown macro with live preview

Write Markdown on the left, and the preview updates on the right. Tables, task lists, quotes, footnotes and note panels in the colours of Confluence panels appear on the page in light and dark mode.

Highlighted code and Mermaid diagrams

Code blocks are highlighted for 27 languages, such as JavaScript, Python, Java, SQL, YAML and Bash. A code block with the language mermaid becomes a diagram.

Search and PDF and Word exports

Confluence search finds the text of the macro. PDF and Word exports show the macro as normal page content: headings, tables, task lists, panels and code. A Mermaid diagram is exported as its code.

Any page in Markdown

Edit in Markdown opens any page as Markdown. Mentions, statuses, dates, macros, images and layouts appear as purple markers and come back unchanged when you save.

Nothing is lost by accident

If you delete a marker, the app lists the items before saving and asks you to confirm. If someone else saves the page while you edit, your changes are not saved over theirs.

Export and import page trees

Export a page and its child pages as a .zip that keeps the order, images and links between pages. Import Markdown files, a folder or a .zip as a page tree with attachments and links.

Copies for AI tools

Copy as Markdown copies a Confluence page as Markdown. In Jira, Copy issue as Markdown copies the summary, key fields, description and comments, or downloads them as a .md file.

Jira descriptions and comments

Edit the issue description in Markdown with a live preview. Paste an answer from an AI tool as a comment, and its headings, tables, task lists and code are saved as a normal Jira comment.

Old wiki markup to Markdown

Jira shows earlier descriptions in the issue history as wiki markup, such as h2. and {code}. Paste it into the editor, and the app offers to convert it to Markdown.

Data stays in Atlassian

No external connections and no storage of their own. Everything runs in the browser with the user’s own permissions, so the apps show and change only what that person can.

Pricing

Up to 10 users

Free in both apps.

100 users in Confluence

USD 350 a year.

100 users in Jira

USD 250 a year.

The Confluence app and the Jira app are billed separately, and Atlassian handles the billing. Prices for other user tiers are shown on the Atlassian Marketplace once the apps are published. Customers on the free tier get the same support as paying customers.

Screenshots

Edit in Markdown in Confluence: the page as Markdown on the left, the preview on the right and protected items as purple markersThe Sharp Markdown macro on a Confluence page: a table, a task list, a warning panel, code and a Mermaid diagramImport Markdown in Confluence: the page tree, an attachment and the preview before any pages are createdEdit description in Markdown in Jira: the issue description as Markdown with a mention as a purple markerComment in Markdown in Jira: a table, a task list and code in Markdown, with the previewJira wiki markup from the issue history converted to Markdown: steps, a table and code

Frequently asked questions

How much does Sharp Markdown cost?
It is free for up to 10 users. For 100 users the Confluence app costs USD 350 a year and the Jira app USD 250 a year. The apps are billed separately, and Atlassian handles the billing.

Do I need both apps?
No. The Confluence app brings Markdown to Confluence pages, and the Jira app to Jira issues. Install the one for the product you use, or both.

Are mentions and macros kept when I edit a page in Markdown?
Yes. Items that Markdown can’t show, such as mentions, statuses, macros, images and layouts, appear as purple markers and come back unchanged when you save. A marker can’t be edited in part, and if you delete one, the app asks you to confirm before saving.

How do I export Confluence pages as Markdown files?
Choose Apps and Export as Markdown from the ••• menu of the page, then Export page and child pages (.zip). In the .zip each page is its own .md file, images and files are in the folder _attachments, and links between the pages become relative links. Up to 500 pages are exported at a time.

How do I import Markdown files into Confluence?
Open the page under which the new pages should go, and choose Apps and Import Markdown from the ••• menu. Choose Markdown files, a folder or a .zip file, for example a repository downloaded from GitHub. You see the page tree, the attachments and the notes before anything is created, and the pages are created with your account.

Does Sharp Markdown work in the Jira Service Management customer portal?
No. The actions work in the Jira issue view. They are not in the Jira Service Management customer portal or the mobile apps.

Does any data leave Atlassian?
No. The apps run on Atlassian’s Forge platform and have no external connections. They store nothing of their own: the Markdown stays in your Confluence pages and Jira issues. Exported files are created in the browser and downloaded to your computer.

What happens if the license isn’t active?
The macro shows its Markdown as plain text, so no content is lost.

Support and terms

Support: support@hdsoft.fi, Monday to Friday 9:00–17:00 Finnish time, in English and Finnish. Response times and security reports are on the support page.

Documentation: how to set up and use Sharp Markdown.

Privacy: privacy policy.

Terms and other apps: Apps for Jira and Confluence.

Coming to the Atlassian Marketplace

Sharp Markdown is coming to Confluence Cloud and Jira Cloud through the Atlassian Marketplace. The documentation already shows how it works.

Read the documentation

Atlassian, Jira and Confluence are trademarks of Atlassian. The apps are made and supported by HD SofT.