Textile轻量级标记语言完全指南

Textile轻量级标记语言完全指南

learnxinyminutes-docs Code documentation written as code! How novel and totally my idea! 项目地址: https://gitcode.com/gh_mirrors/le/learnxinyminutes-docs

Textile是一种轻量级标记语言，它通过简单的文本格式化语法将纯文本转换为结构化的HTML标记。作为HTML的简化版本，Textile语法设计简洁易读，非常适合撰写文章、论坛帖子、文档说明等各类在线发布内容。

核心语法元素

基础文本格式化

Textile提供了多种文本样式标记方式：

1. 强调文本：

   • *加粗文本* → <strong>加粗文本</strong>
   • **粗体文本** → <b>粗体文本</b>

2. 斜体文本：

   • _强调文本_ → <em>强调文本</em>
   • __斜体文本__ → <i>斜体文本</i>

3. 上下标：

   • 上标^示例^ → 上标<sup>示例</sup>
   • 下标~示例~ → 下标<sub>示例</sub>

4. 修改标记：

   • -删除文本- → <del>删除文本</del>
   • +插入文本+ → <ins>插入文本</ins>

段落与区块

Textile提供了灵活的段落控制：

p. 标准段落
p<. 左对齐段落
p>. 右对齐段落
p=. 居中对齐段落
p<>. 两端对齐段落

bq. 这是引用区块
bq.:http://example.com 带出处的引用

pre. 预格式化文本
   保留所有空格和换行

标题结构

创建标题非常简单：

h1. 一级标题
h2. 二级标题
...
h6. 六级标题

高级功能

列表系统

Textile支持多种列表格式：

1. 无序列表：

   * 主项目
   ** 子项目
   * 另一个主项目
   

2. 有序列表：

   # 第一项
   # 第二项
   ## 子项
   

3. 定义列表：

   - 术语 := 定义内容
   - 另一个术语 := 
   多行
   定义内容 =:
   

表格处理

Textile的表格语法直观易用：

|_. 表头1 |_. 表头2 |
| 单元格1 | 单元格2 |

|\2. 跨两列 |
| 列1 | 列2 |

|/2. 跨两行 | 行A |
| 行B |

媒体嵌入

1. 图片插入：

   !/path/to/image.jpg!
   !/path/to/image.jpg(替代文本)!
   

2. 链接创建：

   "显示文本":http://example.com
   

注释与注解系统

1. 普通注释：

   ###. 单行注释
   ###.. 多行注释
   可以跨越多行
   ###..
   

2. 脚注系统：

   正文内容[1]
   
   fn1. 脚注内容
   

特殊字符处理

Textile自动转换多种特殊字符：

• 引号转换："智能引号" → "智能引号"
• 破折号：-- → 长破折号(—)
• 省略号：... → …
• 商标符号：(r) → ®, (tm) → ™, (c) → ©

CSS与HTML集成

Textile支持直接嵌入CSS样式：

p{color:red}. 红色文本
p(my-class). 带class的段落
p(#my-id). 带ID的段落

最佳实践建议

1. 保持一致性：在项目中统一使用某种风格（如统一用*表示加粗）
2. 适度使用注释：合理使用注释提高可读性
3. 利用区块属性：善用对齐、缩进等属性增强排版效果
4. 测试转换结果：不同解析器可能有细微差异，发布前应测试

Textile通过简洁的语法实现了强大的文档格式化能力，特别适合需要频繁更新内容的场景。掌握Textile可以显著提高文档编写效率，同时保持内容的结构化和可读性。

learnxinyminutes-docs Code documentation written as code! How novel and totally my idea! 项目地址: https://gitcode.com/gh_mirrors/le/learnxinyminutes-docs