语法
标题
- h1. 标题一
- h2. 标题二
- h3. 标题三
- h4. 标题四
- h5. 标题五
- h6. 标题六
字体
黑体 | *黑体* |
斜体 | _斜体_ |
-删除线- |
|
下划线 | +下划线+ |
下标sub | 下标 ~sub~ |
上标sup | 上标 ^sup^ |
所有这些标记基本都要保证*
、-
这些字符不在一个英文单词或中文句子的中间,否则无效。可以在外面再加一层空格。
引用
bq. 这是引用,不能换行。
这是引用,不能换行。
其实bq.
能用已经让我很诧异了,因为其它b
开头的标记都挂了。
Textile通常是用p.
来区分段落的,而在JIRA上禁用它后用的是换行符,因此bq.
只能作用于一行。
图片
用两个!
包裹起来。
!/path/to/image! !http://upload-images.jianshu.io/upload_images/245520-8d44d5e7c54148da.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240!
不支持各种杂七杂八的Textile图片语法,例如:
!/path/to/image 10w 20h! !/path/to/image 20%x40%! !/path/to/image 20%! !/path/to/image (Alt text)! 这些统统不支持!
无序列表
Textile是只能用*
,这里JIRA上可以用-
。
* 无序列表一 * 无序列表二 ** 无序列表缩进一次 *** 无序列表缩进二次 ** 无序列表缩进一次 * 无序列表三
- 无序列表一
- 无序列表二
- 无序列表缩进一次
- 无序列表缩进二次
- 无序列表缩进一次
- 无序列表缩进一次
- 无序列表三
有序列表
有序列表不用标序。
# 有序列表一 # 有序列表二 ## 有序列表缩进一次 ### 有序列表缩进二次 ## 有序列表缩进一次 # 有序列表三
- 有序列表一
- 有序列表二
- 有序列表缩进一次
- 有序列表缩进二次
- 有序列表缩进一次
- 有序列表缩进一次
- 有序列表三
表格
|| First name || Family name || | Stephen | Hawking | | Steve | Jobs |
Stephen | Hawking |
Steve | Jobs |
只支持这种简单表格。其中,|
中的是左对齐单元格,||
中的是居中对齐灰底加粗单元格,适合作为表头。
不支持各种Textile杂七杂八的表格语法。
链接
支持显式链接、邮箱,例如:
https://en.wikipedia.org/wiki/Textile_(markup_language) [email protected]
直接可得:
https://en.wikipedia.org/wiki/Textile_(markup_language)
[email protected]
不支持其它任何形式的隐式链接。
也支持 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}
效果如下:
比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的网页编辑区内,它就非常合适。