如何重新格式化 reStructuredText？

Question

我正在 vim 中编写 reST，它可以帮我处理换行符（80 个字符后）。但是，由于我经常返回并编辑之前的文本，行又变得难看。例如，在表格中，有时因为需要在某个地方换行而重新格式化整个表格会很烦人。

所以我希望我有一个程序可以读取我丑陋但正确的 reStructuredText 并以良好的格式和包装输出它。

我发现这种方法pandoc in.rst -w rst基本有效，但也有一些缺点。例如

:author: John Doe

变成

author
    John Doe

标题格式也改变了。遗憾的是，似乎没有rst2rst或类似的东西。有人有什么建议吗？

Answer 1

您可以使用：

setlocal formatoptions+=a

开启 vim 中的段落自动格式化。将该行添加到ftplugin/rst.vimvim 配置目录中的文件中，每次您开始编辑.rst文件时都会自动执行此操作。

如果重新格式化太多，添加选项可能会改善情况w。这导致 vim 仅在行以空格结尾时才考虑将段落扩展到下一行。它会自动在自动插入的行末尾放置一个空格。

Answer 2

如果您希望更好地处理标题栏，请将 -s 与 pandoc 一起使用。