是否将Textile标记转换为Markdown？

Question

我正在合并遗留系统，一些组件使用Markdown，其他组件使用Textile格式。这对我的用户来说是非常混乱的。因此，我想对Markdown进行标准化。

有没有一种方法可以至少将大部分Textile格式自动转换为markdown？

Answer 1

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

因为Textile比Markdown更冗长，所以一些元素(如表)将保持标记为HTML，这对于Markdown来说是很好的，但也可能造成用户的困惑。

Answer 2

即将推出的Pandoc1.8(或当前的github version)可以直接将纺织品转换为Markdown。我不知道它处理多少纺织品，但是

pandoc index.textile -o index.markdown

在这里工作得很好。

Answer 3

就像西蒙说的那样，你可以使用pandoc，一个通用的文档转换器。

单个文件

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

多个文件

要将包含textile文件(包括嵌套目录中的文件)的目录转换为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 manual中有更多的通用信息，但它没有深入讨论转换。