JIRA常用markdown语法整理
Posted
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了JIRA常用markdown语法整理相关的知识,希望对你有一定的参考价值。
参考技术A平时工作中一直是使用JIRA作为项目管理和bug管理的工具。偶然有一次,某位测试同学反映我给的SQL语句执行不了,原来是注释里的 * 被当成加粗的标记给去掉了,类似这样:
然而当时(2012年)还从未听说过markdown这个词(刚刚看了一下百度指数,markdown直到2013年9月才开始火起来,2012年没听说还不算落伍吧……)。
只是觉得这个东西挺有意思的,于是仿照着 *XX* 这种格式,把各种符号枚举了一遍,不过当时只试出了那几种文字样式 _ - + ^ ~ 和表格的语法 | 与 || 。
后来知道markdown之后,又仿照着试出了列表的语法格式。
至此,有了「加粗、列表、表格」这3个常用语法后,JIRA任务描述的排版布局已经可以达到比较不错的阅读体验了。
最近想到要整理一下所有JIRA的markdown语法,终于想到去google一下,然后发现了 「这个网页」 ,我之前用枚举这种笨办法试出来的语法基本都包含在内了(早点怎么没想到去google呢?),还有一些我之前没尝试出来的语法。好在这个页面里并没有表格和列表的语法,之前的尝试还不算毫无价值。
以下这些为平时工作中,所有用到过的JIRAmarkdown语法 :
列出对比是因为用惯JIRA之后,其实并不熟悉一般的markdown,顺便学习一下……
没列对比的是因为那几种语法格式没法插入到表格中……
JIRA中的标记语言的语法参考
前言
看到网上有的文章说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.
来引用一段文字或图片等,可以在引用段里使用字体效果并进行换行。
附件
附件有两种方式:
[^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}
参考链接
以上是关于JIRA常用markdown语法整理的主要内容,如果未能解决你的问题,请参考以下文章