md2vim VS nvim-libmodal

I'm writing markdown documentation and converting it to vim doc via https://github.com/FooSoft/md2vim. Here's an example:

There are utilities such as https://github.com/FooSoft/md2vim that can convert between markdown and vimdoc. One could keep documentation in the readme and then use this to convert to vimdoc?

You might be interested in md2vim , babelfish.nvim :)

md2vim

Only one submode can be currently active, yeah. You can enter new submodes from within others but only one will be intractable at a time.

Maybe I'm alone in it, but I actually have liked VimDoc so far for detailed documentation, because of its structure and conventions. You can typically just copy-paste a few templates from a register and insert your relevant data as needed. As for right-aligning new variables, there's always :h right-align or just foregoing it altogether. The spacing is for look rather than function.

I'm glad to see more development in the user-mode space! I made nvim-libmodal which has layers that do something similar to this, but it seems this particular type of feature is less popular in the Vim community than in Emacs.

There are plugins that do this vim-submode nvim-libmodal for example . So it's possible at least to some extent.

Thanks! This looks like what I'm looking for, actually. From the issues, I found nvim-libmodal and vim-libmodal, which seem more actively maintained. I'll look into them!

Worth a look, but it really doesn't do much aside from adding a couple convenience commands and some modes for markdown manipulation and snippet generation.