The images are very nice looking, but are not searchable or diffable, and very hard to edit (especially for other contributors). In the case where you are presenting a textual idea (such as the existing examples) I would stick to formatted text. I have some experience with this in the bx wiki: