JIRA常用markdown语法整理

作者: 卡拉赞图书馆 | 来源:发表于2016-08-22 17:01 被阅读2186次

    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任务描述示例

    最近想到要整理一下所有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}
    

    相关文章

      网友评论

      • 每日思考:JIRA issue中是用Textile作为标记语言。https://en.wikipedia.org/wiki/Textile_(markup_language)
        每日思考:@UXplayer 我也就是差资料才看到。
        卡拉赞图书馆:非常感谢, 我之前的理解真的都是Holy Shit,今天有种豁然开朗的感觉。
      • sggggy:游戏同行,jira wiki用的666
      • pfgp2n:就因为你用百度,误了一生……
        卡拉赞图书馆:@wendy样儿 如果愿意付费的话,有不少小众的付费翻墙软件,免费的也有、就是费时要自己去找,不稳定了还要换。我私信你了一篇公众号文章,里面推荐了几个,你可以看看。
        823917eebcd3:@UXplayer 怎么翻墙呢
        卡拉赞图书馆:@Alamo_Young :pensive:哎,说多了都是泪,现已全天候翻墙,隔离百度了

      本文标题:JIRA常用markdown语法整理

      本文链接:https://www.haomeiwen.com/subject/ullgsttx.html