Jira wiki markup guide
Markdown Acceptance Criteria to Jira
Convert Markdown acceptance criteria into Jira wiki markup that stays readable in issue descriptions.
Direct answer
Paste the acceptance criteria as Markdown, keep each condition as a bullet or numbered step, then convert headings, lists, inline code, links, and tables into Jira wiki markup before pasting into the issue description.
Open Markdown to Jira converterWhen to use this
- Product specs start in Markdown but the final issue lives in Jira.
- QA needs clear done conditions inside a ticket.
- Acceptance criteria include inline code, links, ordered steps, or tables.
Steps
- Use a clear heading such as Acceptance criteria.
- Keep each criterion as one bullet or one numbered step.
- Add code identifiers with inline code formatting.
- Convert the Markdown to Jira wiki markup.
- Paste the output into the Jira issue description and preview it.
Example conversion
Markdown input
## Acceptance criteria - User can resume the last incomplete quiz - Resume opens the saved question index, not Q0 - Event `resume_click` includes `quiz_slug` and `question_index` | State | Expected | | --- | --- | | Incomplete attempt | CTA appears | | Completed attempt | CTA is hidden |
Jira wiki output
h2. Acceptance criteria
* User can resume the last incomplete quiz
* Resume opens the saved question index, not Q0
* Event {{resume_click}} includes {{quiz_slug}} and {{question_index}}
|| State || Expected ||
| Incomplete attempt | CTA appears |
| Completed attempt | CTA is hidden |Common mistakes
- Do not paste raw Markdown tables into Jira if the field expects wiki markup.
- Avoid putting multiple done conditions in one bullet.
- Preview the Jira ticket after pasting because some Jira editors support Markdown while older wiki fields need Atlassian markup.
FAQ
- Can Jira render Markdown acceptance criteria directly?
- Some Jira editors accept limited Markdown, but Jira wiki fields and older instances expect Atlassian wiki markup. Converting first is safer when tables, code, or links must render correctly.
- Should acceptance criteria be bullets or numbered steps?
- Use bullets for independent conditions and numbered steps when order matters. The converter preserves both as Jira wiki lists.
- Can I include a Markdown table in acceptance criteria?
- Yes. Markdown pipe tables can become Jira wiki tables with double-pipe header cells and single-pipe body rows.