Textile 标记语言 基础语法

语法

标题

• 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.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 name Family name

Stephen	Hawking
Steve	Jobs

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

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

链接

支持显式链接、邮箱，例如：

https://en.wikipedia.org/wiki/Textile_(markup_language)
[e-mail]

 

直接可得：

https://en.wikipedia.org/wiki/Textile_(markup_language)
[e-mail]

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

也支持 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