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)
[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}

效果如下:


一段简单的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

猜你喜欢

转载自memoryforwyl.iteye.com/blog/2335110