text editor with graphic comments

Question

I am a programmer and I am looking for a text editor that can display images in comments. The reason is that when I am documenting some functions, I very often find myself wanting to describe them with images instead of words.

Do this kind of text editors exist?

The file doesn't contain image, it contains links to images or other types of files (in comments), the editor just displays them inline, for the pleasure of the user.

Cross-platform is preferred, or at least it should support Unix-like system such as Linux or OS X.

What programming language one uses shouldn't matter at all, as long as the syntax definition is clear.

Take the following haskell code as an example:

-- Definition of foldn
foldn c h = g where
  g 0 = c
  g n = h $ g (n - 1)

-- # Fibonacci with foldn
-- ![fib](img/fib.png)
fib = let
  f (m, n) = (n, m + n)
  outl (m, n) = m in
    outl . foldn (0, 1) f

This should be rendered in the text editor as:

-- Definition of foldn
foldn c h = g where
  g 0 = c
  g n = h $ g (n - 1)

Fibonacci with foldn

fib = let
  f (m, n) = (n, m + n)
  outl (m, n) = m in
    outl . foldn (0, 1) f

Answer 1

CudaText editor (free, open source) can do it. You need to install plugin "Insert Pics" from "Plugins - Addon Manager - Install".

With plugin installed, open any text file, call plugin commands: "Plugins - Insert Pics - .....", it can add picture files into text, can del them later. It saves pictures to separate files [filename].cuda-pic.