Leafdoc

Details
Iván[0] se enfrentó al problema de documentar una base de código bastante amplia (Leaflet[1]) manteniendo el formato de la documentación existente (que era HTML mantenido manualmente). Y como no le convenció ninguna de las herramientas de generación de documentación (doxygen, javadoc, etc), pues se hizo la suya propia.
Leafdoc[2] es un generador de documentación similar a NaturalDocs y JSdoc y es completamente agnóstica del lenguaje. Genera no sólo documentación basada en Markdown, sino también los diagramas UML.
Si desarrollas y estás buscando forma mejor de documentar tu código O SI NI SIQUIERA DOCUMENTAS, deberías apuntarte a este evento.
Y si no, también.
[0] http://ivan.sanchezortega.es
[1] https://github.com/Leaflet
[2] https://github.com/Leaflet/Leafdoc

Leafdoc