如何从Markdown注释或嵌入式注释生成Vim文档，或者有更好的方法添加文档？

这是两个问题合二为一。最近，我花了很多时间来深入学习vimscript，学习vim的内部知识，并开始编写vim插件。在此过程中，我一直在单独的markdown文件中保留大量注释，并在vimscript文件中添加许多内联的“文档”注释。

我觉得我终于有了一些值得共享的代码，并希望开始添加一些实际文档。我尚未编写任何自己的帮助文档文件，因此我仍在弄清楚该过程。

在没有任何经验或对该工作流程没有扎实的了解的情况下，我正在尝试完成两个任务：


从我的markdown生成帮助文档文件'在vim / vimscript上记录笔记的文件，因此我可以随时快速，轻松地从vim读取/引用。
从vimscript文件中解析内联文档（类似于shocco用于shell脚本的方式）以生成关联的文件Vimscripts的帮助文档。

关于想法的任何建议或建议（这是一个坏主意，因为...，更好的主意是...），或者如何实现它们将不胜感激。