前言
看到網上有的文章說JIRA是使用Textile這門標記語言，有些語法和Wikitext和Markdown相像。JIRA在2017年進行了一次大更新，某些語法可能和以前不大一樣，這里紀錄一下常用的一些語法。
標題
h1.一級標題
h2.二級標題
h3.三級標題
h4.四級標題
h5.五級標題
用法示例：
h1.ddd
一共有h1到h5這五種大小的標題，但是h6也是有效果的，不過h6起到的作用是將小寫字母變成大寫字母，示例如下：
h6.ddd
以上會得到DDD的輸出。
字體
| 用法 | 效果 |
|---|---|
*黑體* |
黑體 |
_斜體_ |
黑體 |
-刪除線- |
|
+下划線+ |
下划線 |
~下標~ |
下標 |
^上標^ |
上標 |
注意在使用上邊這些字體效果的時候，~等字符需要和其他文本相隔一個空格，否則沒有效果，如下：
H ~2~ O
換行
第一行
\\
第二行
通過\\來進行換行。
引用
bq. 這是引用，可以使用字體效果並進行換行。
通過bq. 來引用一段文字或圖片等，可以在引用段里使用字體效果並進行換行。
不過這個bq. 用來比較麻煩，用另一種引用的語法{quote}更好，而且還可以使用其他更多的效果，如下：
{quote}
Perhaps the simplest way to convert to using Log4j 2 is to replace the log4j 1.x jar file with Log4j 2's log4j-1.2-api.jar. However, to use this successfully applications must meet the following requirements:
# They must not access methods and classes internal to the Log4j 1.x implementation such as Appenders, LoggerRepository or Category's callAppenders method.
# They must not programmatically configure Log4j.
# They must not configure by calling the classes DOMConfigurator or PropertyConfigurator.
{quote}
附件
附件有兩種方式：
[^xxxx.mp4]
或者
!xxxx.mp4!
[^xxxx.mp4]這種形式類似於超鏈，!xxxx.mp4!這種形式則可以將圖片顯示出來，或者將視頻播放出來。
如果附件是圖片，還可以使用以下寫法：
顯示圖片的縮略圖
!xxxx.jpg|thumbnail!
指定圖片的大小
!xxxx.jpg|width=300,height=400!
如果附件是視頻 ，還可以使用以下寫法：
指定視頻播放器的大小
!xxxx.mp4|width=300,height=400!
列表
第一種無序列表，會在每行最前邊顯示一個圓點
* 1
* 2
** 2.1
* 3
第二種無序列表，會在每行最前邊顯示一個方塊
- 1
- 2
-- 2.1
- 3
有序列表
# 1
# 2
## 2.1
# 3
有序列表和無序列表可以混合使用，如下：
# 1
# 2
#* 2.1
# 3
表格
表頭加粗寫法：
||heading 1||heading 2||heading 3||
|col A1|col A2|col A3|
|col B1|col B2|col B3|
表頭不加粗寫法：
|heading 1|heading 2|heading 3||
|col A1|col A2|col A3|
|col B1|col B2|col B3|
超鏈
直接貼上一個超鏈：
[https://lewky.cn]
給超鏈起一個別名：
[233|https://lewky.cn]
此外，可以直接輸入JIRA的issue id，會自動轉換成特定的超鏈。
轉義字符
有些特殊字符在JIRA中具有特殊效果，如果需要輸入這些字符，需要進行轉義。JIRA使用的轉義字符是\，用法如下：
\{
表情符號
JIRA支持通過輸入一些特定的組合字符來顯示成對應的表情符號，比如：
:) :( :P :D ;) (y) (n) (i) (/) (x) (!)
(+) (-) (?) (on) (off) (*) (*r) (*g) (*b) (*y) (flag)
(flagoff)
高級文本格式
可以通過{panel}來顯示一個模板塊，如下：
{panel}
Some text
{panel}
可以給這個panel起標題：
{panel:title=My Title}
Some text with a title
{panel}
還可以給這個panel設置css屬性：
{panel:title=My Title|borderStyle=dashed|borderColor=#ccc|titleBGColor=#F7D6C1|bgColor=#FFFFCE}
a block of text surrounded with a *panel*
yet _another_ line
{panel}
代碼塊
代碼塊通過{code}來使用：
{code:xml}
<test>
<another tag="attribute"/>
</test>
{code}
建議給代碼塊設置對應的語言，譬如上邊的xml，這樣寫的好處是代碼塊可以自動使用對應語言的代碼高亮，並且當代碼過長時會自動生成滾動條，不至於讓代碼塊占據頁面的一大塊地方。
同樣可以給代碼塊設置標題和css屬性：
{code:title=Bar.java|borderStyle=solid}
// Some comments here
public String getFoo()
{
return foo;
}
{code}