如何将带有图像的 reStructuredText 文件转换为 markdown？答案

【问题标题】：How to convert reStructuredText files with images to markdown?如何将带有图像的 reStructuredText 文件转换为 markdown？
【发布时间】：2012-06-01 23:26:48
【问题描述】：

我有 rst 文件包含像

这样的行

.. figure:: examples/foo.png 
    :scale: 80%

    Fig. 1 : Illustration of the awesomeness of stackoverflow

现在我希望将此文件转换为降价。我尝试使用pandoc，

pandoc -s -w rst --toc foo.rst -o foo.md

但输出文件foo.md 似乎忽略了图形包含行。那么，我怎样才能在不丢失数字的真棒的情况下转换成markdown文件呢？谢谢

【问题讨论】：

如果你想输出 Markdown，你不想要 -w rst 标志，它告诉它写 rst。

标签： markdown restructuredtext pandoc

【解决方案1】：

This在线演示Pandoc转换如下markdown：

![Map to buried treasure](/path/to/img.jpg "Optional title")

进入以下reStructuredText：

.. figure:: /path/to/img.jpg
   :align: center
   :alt: Optional title

   Map to buried treasure

所以这应该是你如何定义一个可以转换为降价的图形。但是，在在线转换器中使用此 reStructuredText 会导致错误，并显示非常无用的错误消息。运行 Pandoc 时是否收到任何错误消息？

也许您的 reStructuredText 语法不正确：图形（和任何其他）指令的选项应该相对于指令名称缩进。尝试使用

.. figure:: examples/foo.png 
   :scale: 80%

   Fig. 1 : Illustration of the awesomeness of stackoverflow

看看会不会有什么不同。

【讨论】：

我运行 pandoc 时没有报错，而且我的第一个语法是正确的 - 它在其他地方正确显示或转换为 html 等时显示。
那么这可能是 Pandoc 的一个错误。我会向开发人员发送电子邮件或在 Pandoc 邮件列表/问题跟踪器上提出此问题。
当然，而且似乎没有替代工具可以完成这项工作。
您可以尝试的一件事是将 reStructuredText 转换为另一种格式，例如 HTML，然后再转换为 markdown。不是一个很好的解决方案，但值得一试。