JIRA标记语言语法参考:提高文档编写效率


前言

看到网上有的文章说JIRA是使用Textile这门标记语言,有些语法和Wikitext和Markdown相像。JIRA在2017年进行了一次大更新,某些语法可能和以前不大一样,这里纪录一下常用的一些语法。

标题

h1.一级标题
h2.二级标题
h3.三级标题
h4.四级标题
h5.五级标题

用法示例:

h1.ddd
  • 1.

一共有h1到h5这五种大小的标题,但是h6也是有效果的,不过h6起到的作用是将小写字母变成大写字母,示例如下:

h6.ddd
  • 1.

以上会得到​​DDD​​的输出。

字体

用法

效果

​*黑体*​

黑体

​_斜体_​

黑体

​-删除线-​

删除线

​+下划线+​

下划线

​~下标~​

下标

​^上标^​

上标

注意在使用上边这些字体效果的时候,​​~​​等字符需要和其他文本相隔一个空格,否则没有效果,如下:

H ~2~ O
  • 1.

换行

第一行
\\
第二行
  • 1.
  • 2.
  • 3.

通过​​\\​​来进行换行。

引用

bq. 这是引用,可以使用字体效果并进行换行。
  • 1.

通过​​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}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.

附件

附件有两种方式:

[^xxxx.mp4]
或者
!xxxx.mp4!
  • 1.
  • 2.
  • 3.

​[^xxxx.mp4]​​​这种形式类似于超链,​​!xxxx.mp4!​​这种形式则可以将图片显示出来,或者将视频播放出来。

如果附件是图片,还可以使用以下写法:

显示图片的缩略图
!xxxx.jpg|thumbnail!

指定图片的大小
!xxxx.jpg|width=300,height=400!
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.

如果附件是视频 ,还可以使用以下写法:

指定视频播放器的大小
!xxxx.mp4|width=300,height=400!
  • 1.
  • 2.

列表

第一种无序列表,会在每行最前边显示一个圆点

* 1
* 2
** 2.1
* 3
  • 1.
  • 2.
  • 3.
  • 4.

第二种无序列表,会在每行最前边显示一个方块

- 1
- 2
-- 2.1
- 3
  • 1.
  • 2.
  • 3.
  • 4.

有序列表

# 1
# 2
## 2.1
# 3
  • 1.
  • 2.
  • 3.
  • 4.

有序列表和无序列表可以混合使用,如下:

# 1
# 2
#* 2.1
# 3
  • 1.
  • 2.
  • 3.
  • 4.

表格

表头加粗写法:
||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|
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.

超链

直接贴上一个超链:
[https://lewky.cn]

给超链起一个别名:
[233|https://lewky.cn]
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.

此外,可以直接输入JIRA的issue id,会自动转换成特定的超链。

转义字符

有些特殊字符在JIRA中具有特殊效果,如果需要输入这些字符,需要进行转义。JIRA使用的转义字符是​​\​​,用法如下:

\{
  • 1.

表情符号

JIRA支持通过输入一些特定的组合字符来显示成对应的表情符号,比如:

:) :( :P :D ;) (y) (n) (i) (/) (x) (!)
(+) (-) (?) (on) (off) (*) (*r) (*g) (*b) (*y) (flag)
(flagoff)
  • 1.
  • 2.
  • 3.

高级文本格式

可以通过​​{panel}​​来显示一个模板块,如下:

{panel}
Some text
{panel}
  • 1.
  • 2.
  • 3.

可以给这个panel起标题:

{panel:title=My Title}
Some text with a title
{panel}
  • 1.
  • 2.
  • 3.

还可以给这个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}
  • 1.
  • 2.
  • 3.
  • 4.

代码块

代码块通过​​{code}​​来使用:

{code:xml}
<test>
<another tag="attribute"/>
</test>
{code}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.

建议给代码块设置对应的语言,譬如上边的xml,这样写的好处是代码块可以自动使用对应语言的代码高亮,并且当代码过长时会自动生成滚动条,不至于让代码块占据页面的一大块地方。

同样可以给代码块设置标题和css属性:

{code:title=Bar.java|borderStyle=solid}
// Some comments here
public String getFoo()
{
return foo;
}
{code}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.

参考链接

  • ​​JIRA issue 中的标记语言(Textile)​​
  •  ​Text Formatting Notation Help​​


QR Code
微信扫一扫,欢迎咨询~

联系我们
武汉格发信息技术有限公司
湖北省武汉市经开区科技园西路6号103孵化器
电话:155-2731-8020 座机:027-59821821
邮件:tanzw@gofarlic.com
Copyright © 2023 Gofarsoft Co.,Ltd. 保留所有权利
遇到许可问题?该如何解决!?
评估许可证实际采购量? 
不清楚软件许可证使用数据? 
收到软件厂商律师函!?  
想要少购买点许可证,节省费用? 
收到软件厂商侵权通告!?  
有正版license,但许可证不够用,需要新购? 
联系方式 155-2731-8020
预留信息,一起解决您的问题
* 姓名:
* 手机:

* 公司名称:

姓名不为空

手机不正确

公司不为空