Jira2Markdown Node icon

Jira2Markdown Node

Transforms Jira markdown into normal markdown

Jira2Markdown Node

AI-generated

Overview

This node converts text between Jira Wiki Markup, standard Markdown, and HTML formats. It supports four conversion directions: from Jira markup to Markdown, from Markdown to Jira markup, from Jira markup to HTML, and from Markdown to HTML. This is useful for users who need to integrate or migrate content across platforms that use different markup languages, such as syncing documentation between Jira and other markdown-based tools or generating HTML previews.

Practical examples:

  • Converting Jira issue descriptions written in Jira Wiki Markup into Markdown for use in a GitHub README.
  • Transforming Markdown notes into Jira Wiki Markup to paste into Jira tickets.
  • Generating HTML output from Jira or Markdown content for web display.

Properties

Name Meaning
Conversion Type Select the desired conversion direction:
- From Jira to Markdown
- From Markdown to Jira
- From Jira to HTML
- From Markdown to HTML
Input Text The text to be converted based on the selected conversion type
Destination Key The name of the key in the output JSON where the converted text will be stored

Output

The node outputs the original input data with an additional field containing the converted text. The converted text is assigned to the key specified by the "Destination Key" property in each item's JSON object.

For example, if the destination key is set to "markdown", the output JSON for each item will include a "markdown" field holding the converted text.

No binary data output is produced by this node.

Dependencies

  • The node relies on an internal module providing conversion functions between Jira markup, Markdown, and HTML.
  • No external API keys or services are required.
  • No special environment variables or n8n configurations are needed beyond standard node setup.

Troubleshooting

  • Empty or incorrect output: Ensure the "Input Text" property contains valid text in the expected source format matching the chosen conversion type.
  • Unsupported syntax or formatting issues: The conversion functions may not cover all edge cases or custom Jira/Markdown extensions; verify input compatibility.
  • Errors related to missing properties: Confirm that all required properties ("Conversion Type", "Input Text", and "Destination Key") are properly set.
  • Unexpected characters like |smart-link or |smart-card: These substrings are automatically removed before conversion; if they appear in output, check input preprocessing.

Links and References

Discussion