为 vim 生成帮助文件

Question

目前，我直接将文档编写为 vim 帮助文件。有时我需要生成其他格式（例如 PDF）。我的工作流程是复制帮助文件的内容并将它们转换成我需要的东西。这是一项相当乏味的工作，因为我主要需要添加额外的标记。

我喜欢 Markdown 的方法，它可以（例如使用 Pandoc）转换为各种输出格式。不幸的是不是 vim 帮助文件。我正在寻找采用标准输入格式（例如 XML、Markdown、重构文本、纯文本……）并输出vim 帮助文件的转换器。或者有没有其他方法可以在不自己编写这样的转换器的情况下自动生成vim帮助文件？

Answer 1

很抱歉复活了一个非常旧的线程。我是lornix之前mkd2vimdoc建议的第一个链接背后的脚本的作者。我最近从头开始重写为html2vimdoc。它仍然支持 Markdown 作为输入格式；它会将 Markdown 转换为 HTML，然后将该 HTML 转换为 Vim 帮助文件。重写期间的重点是支持更广泛的输入文档。mkd2vimdoc

我和其他几个插件作者正在使用这个新脚本，因此它绝对适合一般用途。如果您想再试一次，我很想知道它现在是否更适合您要使用它的文档。如果它仍然不起作用，请随时在 GitHub 上创建一个问题。

Answer 2

我找到了这个脚本，作者创建该脚本是为了将 markdown 转换为 vim 文档。听起来非常接近您正在寻找的内容。

虽然这个vim.org 脚本（github repo）将 markdown 转换为看起来几乎所有东西，但 vimdoc 除外。（叹气）如此接近......也许有轻微的修改？