Code Editor mit Markup?

Hallo,
kann mich nicht mit Doxygen und Co anfreunden, weil am Ende ein riesen 
Dokument erzeugt wird, das doch niemand anschaut und fast keinen 
Mehrwert hat.

Neben einer saubere Beschreibung der Funktion mit Parametern  und 
Rückgabewerten fehlt mir aber hin und wieder doch die Möglichkeit eine 
Grafik zum Verständnis direkt im Code einzufügen. Gibt es einen Code 
Editor, der zum Beispiel ein  /*[img="/docu/pics/filterstruktur.png"] */ 
als Bild darstellt?

Saxo