markdown - 将 Textile Markup 转换为 Markdown？

Question

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

有没有办法至少将 Bulk of Textile 格式自动转换为 markdown？

Answer 1

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

pandoc index.textile -o index.markdown

在这里工作得很好。

Answer 2

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

因为 Textile 比 Markdown 更冗长，所以某些元素（如表格）将保持标记为 HTML，这对 Markdown 来说非常好，但也可能是您的用户混淆的根源。

Answer 3

就像 Simon 说的，你可以使用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

降价输出的一些问题：

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

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