LDoc is a LuaDoc-compatible documentation generator which can also process C extension source. Markdown may be optionally used to render comments, as well as integrated readme documentation and pretty-printed example files.
Why do you think that https://github.com/lua-rocks/core-deprecated is a good alternative to ldoc