nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

How do I convert HTML into Jira Wiki..?

Nico K_5yr77l

I will be importing data from an existing ALM tool into Jira and the Description in the ALM tool is stored in HTML. Since I cannot send the HTML via the Jira REST API I want to know if there is a way to Send the REST API HTML or Ask the REST API to convert HTML to the wiki markdown format supported by Jira.

I know you can get the HTML from Jira again as a rendered field, but my need is to move data into Jira but try to keep as much of the formatting as possible.

Accepted answers

All comments

Alexey Matveev

Hello,

You can have a look at the following thread:

https://community.atlassian.com/t5/Questions/HTML-to-Wiki-Style-Renderer-markup/qaq-p/203748

Nico K_5yr77l

Thank you. Is there no JIRA REST API Call where the Atlassian Jira solution can take HTML and give me back the correct markdown it needs..?

Seems odd that it would not have this since it does render back HTML as a rendered field when you get items (issues).

Alexey Matveev

I am not aware of such Rest Api

Phil_Dimeski

Has this issue been resolved. I am stuck in the same situation. @Alexey Matveev you said you are aware of such Rest API do you mind sharing it?

Satheesh JM

Ok This is what I ended up doing for my use case..

I used the atlassian renderer library

<dependency>
            <groupId>com.atlassian.renderer</groupId>
            <artifactId>atlassian-renderer</artifactId>
            <version>8.0.32</version>
</dependency>

First I converted html to Markup first using

new DefaultWysiwygConverter().convertXHtmlToWikiMarkup(html);

Then instead of using the v3 jira API, I used the v2 API as the v2 API accepts markup
(https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-issue-comments/#api-rest-api-2-issue-issueidorkey-comment-post)

Szymon Kaczmarek

I tried the same thing but now I have following error:

<span>java.lang.NoClassDefFoundError: com/opensymphony/util/TextUtils</span>

Same like here. I tried adding

com.opensymphony.xwork

but with no luck. Did you have any similar problems?

Satheesh JM

@Szymon Kaczmarek
Yeah I got some similar errors, which were mainly because of dependency conflicts with other libs.
Here's my final pom.xml

<repositories>
   <repository>
      <snapshots>
         <enabled>false</enabled>
      </snapshots>
      <id>central</id>
      <name>Central</name>
      <url>https://repo1.maven.org/maven2/</url>
   </repository>

   <!--atlassian-renderer:8.0.32 is not part of the central repo. to work around that, all these other repos are needed -->
   <repository>
      <snapshots>
         <enabled>false</enabled>
      </snapshots>
      <id>jcenter</id>
      <name>bintray</name>
      <url>https://jcenter.bintray.com</url>
   </repository>
   <repository>
      <snapshots>
         <enabled>false</enabled>
      </snapshots>
      <id>atlassian-3rdparty</id>
      <name>Atlassian 3rd-P Old Repository</name>
      <url>https://maven.atlassian.com/3rdparty/</url>
   </repository>
   <repository>
      <snapshots>
         <enabled>false</enabled>
      </snapshots>
      <id>mulesoft</id>
      <name>Mulesoft</name>
      <url>https://repository.mulesoft.org/nexus/content/repositories/public/</url>
   </repository>

</repositories>
<dependencies>
   .
   .
   .
   <dependency>
      <groupId>com.atlassian.renderer</groupId>
      <artifactId>atlassian-renderer</artifactId>
      <version>8.0.32</version>
   </dependency>
   <dependency>
      <groupId>log4j</groupId>
      <artifactId>log4j</artifactId>
      <version>1.2.17-atlassian-3</version>
   </dependency>
   .
   .
   .
</dependencies>

for me the dependency conflict was in log4j library so I explicitly added it.
you will need to figure out all the conflicting dependencies...

Szymon Kaczmarek

It works! Thank you!

Akash Ingole_s1bwil

You can use text formatting notations -

Like in place of <h1></h1> You will have to send "h1. Creating of an issue using project keys and issue type names using the REST API" as description.

https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all&error=login_required&error_description=Login+required&state=b082ac30-a6e7-486f-affd-e73f5af60425

Hope this helps !

Daniel Brown_b7r2mx

If you're using Python, I like this tool: https://pypi.org/project/html2jirawiki/
I literally plugged it into my import script, and it converted the HTML from Wrike to Jira Wiki. Love it!

Welcome!

It looks like you're new here. Sign in or register to get started.

Quick Links

Find more posts tagged with

jira

rest-api

jira-administration