Editing Rich-Text Fields
When you create, edit or comment on a JIRA issue, some fields may display two small icons at the bottom of the text area: a blue screen – the Preview icon – and a question-mark – the Help icon. The presence of these icons indicates that this field supports JIRA's Text Formatting Notation, which allows you to use rich-text features such as:
- Italic, bold, underlined text.
- Multiple levels of headings.
- Bullets, numbered lists, tables and quotations.
- Images.
- Macros (see below).
Click the Help icon to see a popup window containing the Text Formatting Notation Help.
Using Macros
The JIRA Text Formatting Notation and macros will only be available if your JIRA administrator has configured the relevant renderers.
JIRA ships with the following macros:
Macro | Description | Enabled by default |
---|---|---|
Anchor Macro | Create an anchor that allows people to link to a specific point in a page. Usage:
| yes |
Code Macro | Format blocks of source-code or XML. The default language is Java but you can specify JavaScript, ActionScript, XML, HTML and SQL too. Usage:
| yes |
Quote Macro | Generate blockquotes that may contain multiple paragraphs or complex markup. Usage:
| yes |
No Format Macro | Create blocks of text where other wiki formatting is not applied. Usage:
| yes |
Panel Macro | Draw a panel with the following optional parameters:
| true |
Color Macro | Change the color of the contained text. Usage:
You can use any of the sixteen standard HTML colors ('aqua','black','blue','fuschia','green','gray','lime', 'maroon','navy','olive','purple','red','silver','teal','white','yellow'), or any hexadecimal color code (e.g. '#336699'). | yes |
Lorem Ipsum Macro | Insert paragraphs of "lorem ipsum" space-filler text. Usage:
| yes |
HTML Macro | Use HTML code within a Jira Issue. Usage:
| no |