将 Textile 标记转换为 Markdown？

Question

我正在合并旧系统，一些组件使用 Markdown，其他组件使用 Textile 格式。这让我的用户非常困惑。因此我想对 Markdown 进行标准化。

有没有办法将至少大部分 Textile 格式自动转换为 Markdown？

Answer 1

即将推出的 pandoc 1.8（或当前的 github 版本）可以直接将 Textile 转换为 Markdown。我不知道它处理多少纺织品，但是

pandoc index.textile -o index.markdown

在这里工作得很好。

Answer 2

由于 Markdown 和 Textile 都旨在生成 HTML，因此请考虑首先将所有 Texile 转换为 HTML。
有许多 Markdown 实现也支持将 HTML 转换回 Markdown。 Pandoc 就是一个例子。另一种可能的解决方案是使用 XSLT。

由于 Textile 比 Markdown 更详细，因此某些元素（例如表格）将保持标记为 HTML，这对于 Markdown 来说完全没问题，但也可能会给用户带来困惑。

Answer 3

就像西蒙所说，您可以使用 pandoc，一个通用文档转换器。

单个文件

pandoc --from textile --to markdown "input.textile" -o "output.md"

多个文件

要将充满纺织文件的目录（包括嵌套目录中的文件）转换为 Markdown，您需要循环遍历每个文件并每次调用 pandoc：

for textile_filename in ./**/*.textile; do
    markdown_filename="${textile_filename%.textile}.md"
    printf "Converting %s to %s\n" $textile_filename $markdown_filename
    pandoc --from textile --to markdown $textile_filename -o $markdown_filename
done

Markdown 输出的一些问题：

• 元数据标头（YAML Front Matter ) 已损坏，需要重新格式化为原始格式。 Textile 和 Markdown 之间的元数据标头是相同的，因此不必更改。
• 段落中会添加新行，使其短于特定字符长度，因此您必须删除所有句子中多余的新行。您将得到 8 行，每行约 80 个字符，而不是一长行 500 个字符（您的段落）。

如果您发现一些烦人的事情，或者找到解决这些问题的方法，请随时添加到此列表中。Pandoc 手册，但它没有深入介绍转换。