I've used Marginalia[1] in the past, which more or less embeds markdown in clojure comments as a sort of literate programming lite. It has the payoff that it can generate rather nice docs[2] but without something like that, I'm not sure there's much benefit to the hierarchy.

[1] https://github.com/gdeer81/marginalia [2] http://gdeer81.github.io/marginalia/