md2jira-cli

Convert Markdown to Jira Wiki Markup from the command line.

Install

# Global install
npm install -g md2jira-cli

# No install needed
npx md2jira-cli input.md

Usage

File to stdout

md2jira input.md

File to file

md2jira input.md -o output.txt

Pipe from stdin

# macOS / Linux
cat input.md | md2jira

# Windows (PowerShell)
Get-Content input.md | md2jira

Example

Given ticket.md:

# Bug: login fails on Safari

**Steps to reproduce:**

1. Open Safari
2. Go to `/login`
3. Submit the form

`console.error` shows a CORS error.

| Browser | Status   |
| ------- | -------- |
| Chrome  | ✅ Works |
| Safari  | ❌ Fails |

Running md2jira ticket.md outputs:

h1. Bug: login fails on Safari

*Steps to reproduce:*

# Open Safari
# Go to /login
# Submit the form

{{console.error}} shows a CORS error.

|| Browser || Status ||
| Chrome | ✅ Works |
| Safari | ❌ Fails |

Options

| Argument / Option | Description | | ------------------------ | --------------------------------------------------------------------------------------------------------------------------- | | [input] | Input Markdown file. Omit to read from stdin. | | -o, --output <file> | Write output to a file instead of stdout. | | -f, --format <format> | Output format: wiki (default), adf (Atlassian Document Format JSON), or confluence (Confluence Storage Format XHTML). | | --base-url <url> | Absolute base URL prepended to relative links (e.g. https://company.atlassian.net/wiki). | | --disable <transforms> | Suppress one or more transforms. Comma-separated or repeat the flag. See values below. | | -V, --version | Print version number. | | -h, --help | Display help. |

--disable values

heading · list · code · blockquote · table · thematicBreak · panel

Examples

Output ADF JSON:

md2jira input.md --format adf
cat input.md | md2jira -f adf > output.json

Output Confluence Storage Format:

md2jira input.md --format confluence
cat input.md | md2jira -f confluence > output.xml

Resolve relative links against a Confluence base URL:

md2jira input.md --base-url https://company.atlassian.net/wiki

Suppress heading and list transforms:

# Comma-separated
md2jira input.md --disable heading,list

# Repeated flag
md2jira input.md --disable heading --disable list

Combine options:

md2jira input.md \
  --base-url https://company.atlassian.net/wiki \
  --disable panel \
  --format adf \
  -o output.json

Related

• md2jira-core — the underlying conversion library (use in Node.js / Deno / Bun)
• Live Demo — browser app

Support the Project

If you find this tool useful, consider buying me a coffee :)

License

MIT