I just did it. I use Markdown for bash-modules documentation. :-/

A procedure in bash can have way more complex interface than simple function call. See http://vlisivka.github.io/bash-modules/arguments.html for example.