Ranked in these QuestionsQuestion Ranking
Pro Markdown support
All the comments are run through a markdown parser, while all the code is run through Highlight.js for code highlighting.
Pro Great for beginners
Since Docco doesn't enforce any comment style or rules, it's great for beginners who can instantly pick up without having to learn any new syntax or style.
Con Does not enforce a pattern in writing comments
Since Docco only accepts comment lines starting with double slashes, it does not really enforce any pattern in writing comments, at least not as much as it would if it would use comment blocks. This can bring a huge disparity and even make it harder for Docco to generate good documentation as the project grows larger.