2017-09-16 更新
JIRA 用的是 textile 语法,与 markdown 不同,两者都属于 markup language,
因此本文的标题其实就是错误的,内容更是重新造轮子、浪费时间的整理,
如果想了解JIRA里所使用的标记语言,直接看 textile 语法即可,参考资料:
https://www.promptworks.com/textile/phrase-modifiers#strong-importance
https://en.wikipedia.org/wiki/List_of_document_markup_languages
这篇文章无价值,留着仅用于作为自己的警示,不建议其他人浪费时间往下看
平时工作中一直是使用JIRA作为项目管理和bug管理的工具。偶然有一次,某位测试同学反映我给的SQL语句执行不了,原来是注释里的*
被当成加粗的标记给去掉了,类似这样:
/*功能id:102 , 37级开启*/
↓↓↓变成了↓↓↓
/功能id:102 , 37级开启/
然而当时(2012年)还从未听说过markdown这个词(刚刚看了一下百度指数,markdown直到2013年9月才开始火起来,2012年没听说还不算落伍吧……)。
只是觉得这个东西挺有意思的,于是仿照着*XX*
这种格式,把各种符号枚举了一遍,不过当时只试出了那几种文字样式_ - + ^ ~
和表格的语法|
与||
。
后来知道markdown之后,又仿照着试出了列表的语法格式。
至此,有了「加粗、列表、表格」这3个常用语法后,JIRA任务描述的排版布局已经可以达到比较不错的阅读体验了。
最近想到要整理一下所有JIRA的markdown语法,终于想到去google一下,然后发现了「这个网页」 ,我之前用枚举这种笨办法试出来的语法基本都包含在内了(早点怎么没想到去google呢?),还有一些我之前没尝试出来的语法。好在这个页面里并没有表格和列表的语法,之前的尝试还不算毫无价值。
以下这些为平时工作中,所有用到过的JIRAmarkdown语法:
列出简书对比是因为用惯JIRA之后,其实并不熟悉一般的markdown,顺便学习一下……
没列对比的是因为那几种语法格式没法插入到表格中……
文字样式
JIRAmarkdown | 简书markdown |
---|---|
*加粗* |
**加粗** |
_斜体_ |
_斜体_ |
-删除线- |
~~删除线~~ |
+下划线+ |
<u>下划线</u> |
^上标^ |
<sup>上标</sup> |
~下标~ |
<sub>上标</sub> |
标题
JIRAmarkdown | 简书markdown |
---|---|
h1. 1级标题 |
# 1级标题 |
h2. 2级标题 |
## 2级标题 |
... |
... |
h6. 6级标题 |
###### 6级标题 |
链接
[文字|http://url]
列表
# 有序列表
## 有序列表
- 无序列表
-- 无序列表
表格
||标题||标题||标题
|内容|内容|内容
|内容|内容|内容
代码
{code:none}
print("插入代码,上面的none表示code类型")
print("code类型支持actionscript, html, java, javascript, sql, xhtml, xml, none,")
{code}