skills.rest
mulhamna
mulhamnaCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

render

Render Markdown into Jira Atlassian Document Format with ADF preview.

46|12|Updated Apr 15, 2026
Search Tags:#markdown#validation#jira#adf#mentions#content preview#issue descriptions
One-click install
npx skills add https://github.com/mulhamna/jira-commands --skill render-mulhamna
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: render
Source: https://github.com/mulhamna/jira-commands/tree/main/plugin/skills/render
Command: npx skills add https://github.com/mulhamna/jira-commands --skill render-mulhamna

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents broken or surprising Jira formatting by showing exactly how your Markdown will be converted to Jira’s Atlassian Document Format (ADF) before you send it as a description or comment.

Core Features & Use Cases

  • Render Markdown to Jira ADF: Converts your Markdown into the ADF structure Jira expects so you can catch issues early.
  • Validate for common rendering pitfalls: Flags likely trouble spots such as unsupported HTML, raw images, and complex tables.
  • Mention-aware preview: Shows how recognized @username-style syntax will become mention nodes in the ADF.

Quick Start

Preview this markdown before posting it by running jirac issue render with your draft file as the input.

Frequently Asked Questions about render

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I preview Markdown before posting it to a Jira issue description?▼

You can render Markdown into Jira Atlassian Document Format to see exactly how it will appear as an issue description or comment. This previews mentions, code blocks, and lists while flagging unsupported HTML or raw images before posting.

Why does my Markdown break when I add it to a Jira comment?▼

Markdown breaks in Jira comments because the platform expects Atlassian Document Format rather than standard Markdown syntax. Rendering your draft beforehand validates the structure and flags unsupported HTML or complex tables that cause malformed formatting.

Does this Markdown to Jira ADF converter support @username mentions?▼

Yes, the Markdown to Jira ADF conversion supports @username mentions. It provides a mention-aware preview that shows exactly how recognized @username syntax will transform into mention nodes within the final Atlassian Document Format output.

Do I need jirac to render Markdown for Jira issue descriptions?▼

Yes, you need jirac availability to render Markdown for Jira issue descriptions. The Skill operates by running the jirac issue render command, accepting your draft file or stdin input to generate the ADF preview.

What are the limitations of converting Markdown to Atlassian Document Format?▼

Limitations of converting Markdown to Atlassian Document Format include handling unsupported HTML, raw images, and complex tables that may not render correctly. The preview explicitly flags these risky elements so you can adjust your content before posting.

Related Skills

Explore More Content & Communication Skills→
wangl-ccwangl-cc
8

markdown-writing

Draft and revise Markdown content that follows markdownlint rules.

Community
Intermediate
IainMclIainMcl

jira-cli

Fetch, search, create, and edit Jira tickets via command-line interface.

Community
Intermediate
mulhamnamulhamna
46

jirac

Manage Jira issues via command-line for triage, execution, and reporting workflows.

Community
Advanced
fartybobofartybobo
4

create-jira-ticket

Create Jira tickets from conversation and code context in Atlassian Document Format.

Official
Advanced