---
title: "HTML and Jira Markup Conversion"
canonical: "https://support.appfire.com/space/TSH/1800962676/HTML%20and%20Jira%20Markup%20Conversion"
format: markdown
---
Conversion between HTML and Jira Markup has been significantly improved starting from TFS4JIRA version 7.1. The main objective in version 7.1 is to convert most styles you could pick in TFS or Jira Rich Text Editors properly, and therefore some tags might not be covered if they are not listed at the default text editor.

HTML conversion works for description, comments and any RichText type fields.  Due to the complexity of HTML tree structure, parsing HTML and converting them to JIRA Markups might not be 100% accurate. You will find an example and a list of supported HTML tags below.

# Example 

| **TFS/Azure DevOps (formerly VSTS)** | **Jira** |
| --- | --- |
| ![image](media://ae8e18a6-b94f-4913-9f38-92dc64d1d007) | ![image](media://15d58099-d66f-41c2-bd9c-c743b4bfeaef) |


# Supported Rich Text HTML tags

| **HTML TAG** | **JIRA MARKUP** | **JIRA → TFS** | **TFS → JIRA** |
| --- | --- | --- | --- |
| **<b>** | * | :check_mark: | :check_mark: |
| **<u>** | + | :check_mark: | :check_mark: |
| **<i> / <em>** | _ | :check_mark: | :check_mark: |
| **<ul>** | - ITEM | :check_mark: | :check_mark: |
| **<ol>** | # ITEM | :check_mark: | :check_mark: |
| **<h[1-6]> tags** | h[0-6]. | :check_mark: | n/a |
| **<font color="*"> <span style="color: *">** | {color} | :check_mark: | n/a |
| **anchor / mail link / external link** | [] | :check_mark: | n/a |
| **<sub>** | ~ | :check_mark: | n/a |
| **<sup>** | ^ | :check_mark: | n/a |
| **<del>** | -{TEXT}- | :check_mark: | n/a |
| **<cite>** | ?? | :check_mark: | n/a |
| **<table>** | ||header||   
|cell| | :check_mark: | n/a |
| **n/a** | @ | :check_mark: | n/a |
| **code panel** | {code} | :check_mark: | n/a |
| **no formatting** | {noformat} | :check_mark: | n/a |
| **panels** | {panel} | :check_mark: | n/a |
| **<hr>** | ---- | :check_mark: | :check_mark: |
| **<img> (internal images)** | !...! | :warning: | :warning: |
| **<img> (external images)** | !..! | :check_mark: | :check_mark: |

#   
Known issues (Unsupported)

1) **TFS4JIRA CLOUD - Native ONLY**: At the moment, images in the description or comments are not synchronized fully. TFS4JIRA keeps the <img> tag for the images, but it does not change its original href location.

> ⚠️ ### Example
> ⚠️ 
> ⚠️ If a user pastes an image in the description field, the description will be synchronized to the TFS work item with <img> tag having "href" attribute pointing to the Jira host. Therefore, users can see those images in the description field only if they have signed in both the Jira instance and TFS instance in the browser.

  
2) Copied some customized HTML content and pasted it into the rich text editor might be converted unproperly during the synchronization.

3) Emoticons you use in Jira are also images. Because of the reason mentioned at the 1st point, TFS4JIRA converts them to some corresponding text

| **Jira** | **TFS / Azure DevOps (formerly VSTS)** |
| --- | --- |
| 🙂 | :) |