如何将 .rst 文件转换为 .md？

【问题标题】：How to convert .rst files to .md?如何将 .rst 文件转换为 .md？
【发布时间】：2018-01-19 21:12:04
【问题描述】：

我有一个 .rst 文件形式的 doc，如何轻松、完全地将其转换为 .md？我找到了一个名为 pandoc 的工具，但它没有正确转换文件。它像

pandoc about.rst -s -o about.md

有没有可用的工具？

【问题讨论】：

具体是什么不能正确转换？
我有类似 [pandoc warning] ignoring unknown directive: toctree "source" 的警告，并且一些文件丢失了部分内容。
Markdown 支持的只是 HTML 的有限子集。因此，它不能代表其他标记语言的所有内容。如果要转成 Markdown，那么源文档只能包含 Markdown 支持的功能。可能有解决方法，但为了让我们提供帮助，您需要提供有关您收到的错误以及导致这些错误的输入的具体信息。

【解决方案1】：

首先syntax for using pandoc 是：

pandoc [options] [input-file]…

你这样做了：

pandoc [input-file] [options]…

要更正它，请执行以下操作：

pandoc -s -o about.md about.rst

正如@Waylan 在他们的评论中提到的，Markdown 支持一小部分 reStructuredText 功能。然而，Pandoc 提供了一个extended version of Markdown，可以通过扩展来启用它。这可能会解决您的一些错误，但不能解决其他错误。

最终，您需要使用完整的错误堆栈来编辑您的问题以改进它（不要回复评论）以获得进一步的帮助。

【讨论】：