Textile 标记语言 基础语法

Textile语法详解与应用
本文介绍了Textile标记语言的基础语法,包括标题、字体、引用、图片、无序列表、有序列表、表格和链接的使用方法。同时指出在特定环境下如JIRA中,Textile的一些高级功能可能不被支持,但其在无法输入TAB的网页编辑环境下仍具有一定的优势。

语法

标题

  • h1. 标题一
  • h2. 标题二
  • h3. 标题三
  • h4. 标题四
  • h5. 标题五
  • h6. 标题六

字体

显示输入
黑体*黑体*
斜体_斜体_
删除线-删除线-
下划线+下划线+
下标sub下标 ~sub~
上标sup上标 ^sup^

所有这些标记基本都要保证*-这些字符不在一个英文单词或中文句子的中间,否则无效。可以在外面再加一层空格。

引用

bq. 这是引用,不能换行。

 

这是引用,不能换行。

 

其实bq.能用已经让我很诧异了,因为其它b开头的标记都挂了。

Textile通常是用p.来区分段落的,而在JIRA上禁用它后用的是换行符,因此bq.只能作用于一行。

图片

用两个!包裹起来。

!/path/to/image!
!https://i-blog.csdnimg.cn/blog_migrate/2ef13082bb6173788ddfb35ed407abb1.webp?x-image-process=image/format,png!

 


textile.png

不支持各种杂七杂八的Textile图片语法,例如:

!/path/to/image 10w 20h!
!/path/to/image 20%x40%!
!/path/to/image 20%!
!/path/to/image (Alt text)!

这些统统不支持!

 

无序列表

Textile是只能用*,这里JIRA上可以用-

* 无序列表一
* 无序列表二
** 无序列表缩进一次
*** 无序列表缩进二次
** 无序列表缩进一次
* 无序列表三

 

  • 无序列表一
  • 无序列表二
    • 无序列表缩进一次
      • 无序列表缩进二次
    • 无序列表缩进一次
  • 无序列表三

有序列表

有序列表不用标序。

# 有序列表一
# 有序列表二
## 有序列表缩进一次
### 有序列表缩进二次
## 有序列表缩进一次
# 有序列表三

 

  1. 有序列表一
  2. 有序列表二
    1. 有序列表缩进一次
      1. 有序列表缩进二次
    2. 有序列表缩进一次
  3. 有序列表三

表格

|| First name || Family name ||
| Stephen    | Hawking     |
| Steve      | Jobs        |

 

First nameFamily name
StephenHawking
SteveJobs

只支持这种简单表格。其中,|中的是左对齐单元格,||中的是居中对齐灰底加粗单元格,适合作为表头。

不支持各种Textile杂七杂八的表格语法。

链接

支持显式链接、邮箱,例如:

https://en.wikipedia.org/wiki/Textile_(markup_language)
mail@company.com

 

直接可得:

https://en.wikipedia.org/wiki/Textile_(markup_language)
mail@company.com

不支持其它任何形式的隐式链接。

也支持 JIRA issue ID 号自动转换为链接。

代码

无论是Textile的内联代码@inline@、还是代码块bc. code block,都不支持。

但是后来发现,支持一个形式为{code:language}{code}的语法。

{code:java}
public class Hello {
    public static void main(String[] args) {
        System.out.println("Hello world!");
    }
}
{code}

 

效果如下:


一段简单的Helloworld.png

比Markdown麻烦一些,但更明了。

不支持

  • 不支持脚注
  • 不支持对齐
  • 不支持缩进
  • 不支持p.
  • 不支持pre.或pre..
  • 不支持特殊字符(c)(tm)等。
  • 不支持HTML插入

编辑器

我一般不用Textile,所以没有研究过专门的编辑器。

在JIRA上,通过Firefox的Vimperator的Ctrl+i,把编辑区转到Vim中编辑。

Plugin 'timcharper/textile.vim'

 

通过上述插件,可以实现语法高亮,比大多数Vim的Markdown插件好得多。
虽然也支持预览,但是很遗憾我的工作平台是Windows,没有配置Ruby环境。

结语

Textile这种标记语言,它的一些语法细节还是比流行的Markdown更合适做工作内容交流。比如多重列表,在不能输入TAB的网页编辑区内,它就非常合适。

 

摘自:http://www.jianshu.com/p/834021d6cab6

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值