语法
标题
- 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图片语法,例如:
!/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 |
First name | Family name |
---|---|
Stephen | Hawking |
Steve | Jobs |
只支持这种简单表格。其中,|
中的是左对齐单元格,||
中的是居中对齐灰底加粗单元格,适合作为表头。
不支持各种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}
效果如下:

比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的网页编辑区内,它就非常合适。