Documentation for JIRA 5.2. Documentation for other versions of JIRA is available too.

When you create, edit or comment on a JIRA issue, some fields may display two small icons at the right of the text area: a blue screen (the 'Preview' icon) and a yellow question-mark (the 'Help' icon). The presence of these icons indicates that this field supports JIRA's Text Formatting Notation, allowing you to use rich-text features such as:

  • 斜体、太字、下線付きテキスト。
  • 複数レベルの見出し。
  • 箇条書き、番号付きリスト、表、引用符。
  • 画像。
  • マクロ (下記参照)。

For example, to include an image in the field, you would first attach the image to the issue, then type the following into the field:

To preview what the field will look like after you save it, click the 'Preview' icon:

Click the 'Help' icon to see a popup window containing the Text Formatting Notation Help.

マクロを使用する

JIRA テキスト書式の表記およびマクロは、JIRA 管理者により関連する レンダラーが設定されていた場合にのみ利用できます。

JIRA には次のマクロが同梱されています。

マクロ

説明

デフォルトで有効

アンカー マクロ

ページ内の特定の場所にリンクできるアンカーを作成します。使用方法:

{anchor:bookmark1}
... text here ...
[#bookmark1]

はい

コー​​ド マクロ

ソースコードや XML のブロックを書式設定します。デフォルト言語は Java ですが、JavaScript、ActionScript、XML、HTML、および SQL も指定できます。使用方法:

--- Java example ---
{code:title=Bar.java|borderStyle=solid}
// Some comments here
public String getFoo()
{
 return foo;
}
{code}
*--- XML example ---*
{code:xml}
<test>
 <another tag="attribute"/>
</test>
{code}

はい

引用文生成マクロ

複数の段落や複雑なマークアップを含む引用文を生成します。使用方法:

{quote}
This is text from another source
{quote}
                            

はい

書式なしマクロ

他の wiki 書式設定が適用されないテキスト ブロックを作成します。使用方法:

{noformat}
This is text  \#&@!@(*!&*@()#*@\ \\
{macros} _wont_work_here
{noformat}  

はい

パネル マクロ

次のオプションのパラメーターを持つパネルを描画します。

  • title:パネルのタイトル
  • borderStyle:このパネルで使用する枠線のスタイル(実線、破線、その他有効な CSS 枠線スタイル)
  • borderColor:このパネルで使用する枠線の色
  • borderWidth:このパネルで使用する枠線の幅
  • bgColor:このパネルの背景色
  • titleBGColor:このパネルのタイトル部分の背景色です

    {panel}Some text{panel}
    {panel:title=My Title}Some text with a title{panel}
    {panel:title=My Title| borderStyle=dashed| borderColor=#ccc| titleBGColor=#F7D6C1| bgColor=#FFFFCE}
    a block of text surrounded with a *panel*
    yet _another_ line
    {panel} 

true

Colour Macro

Change the colour of the contained text. Usage:

{color:red}
look ma, red text!
{color}

You can use any of the sixteen standard HTML colours ('aqua','black','blue','fuschia','green','gray','lime', 'maroon','navy','olive','purple','red','silver','teal','white','yellow'), or any hexadecimal colour code (e.g. '#336699').

はい

ロレム イプサム マクロ

"ロレム イプサム'' のダミー テキストの段落を挿入します。使用方法:

{loremipsum}

はい

HTML マクロ

JIRA 課題内で HTML コードを使用します。 使用方法:

{html}
<p>You'll find a lot more in <A href="chapter2.html">chapter two</a>.
See also this <a href="../images/forest.gif">map of the enchanted forest.</A></p>
{html}

いいえ

3 Comments

  1. Anonymous

    I used the Preview button while creating an issue and saw the format of the text with no problem.  However, when I tried to close the preview (using the icon that replaced the preview icon), the window closed and all data was gone.  Is there another way to get out of the preview mode without this happening?

    Thanks,

    Steve

    1. SusanA

      This sounds like either user error or a bug. The best place to get help in either case is JIRA Support: https://support.atlassian.com/ja/ or https://answers.atlassian.com/.

  2. Anonymous

    Is there a way to have INLINE noformat blocks? Currently noformat puts the block in a new line...