I've used https://github.com/jceb/vim-orgmode for a while now for managing documentation written with org-mode. It gets the job done, but if my project's docs weren't written in org-mode already, I'd just use markdown.