☰

生成 vim 的帮助文件

tag-icon • tag-icon vim
生成 vim 的帮助文件

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

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

答案1

mkd2vimdoc抱歉，我又重新提起一个很老的帖子。我是第一个链接的脚本作者洛尼克斯之前。我最近mkd2vimdoc从头开始重写了html2vimdoc。它仍然支持 Markdown 作为输入格式；它将 Markdown 转换为 HTML，然后将该 HTML 转换为 Vim 帮助文件。重写期间的重点是支持更广泛的输入文档。

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

答案2

我发现这脚本，作者创建了该脚本来将 markdown 文档转换为 vim 文档。听起来很接近您要找的内容。

尽管这vim.org 脚本（github 仓库) 将 markdown 转换为几乎所有看起来像 vimdoc 的东西。(叹气) 这么接近了...也许需要稍微修改一下？

相关内容