Introducing FigureMark

While working on my pandoc-based Markdown publishing system, it seemed to me that when writing non-fiction content, there was no accessible way to mark-up content for the purpose of explanation, examination, and education. So I made one! It’s called FigureMark, and I invite you to take a look. Here’s an example:

To be, or not to be, that is the question: 1 Whether 'tis nobler in the mind to suffer The slings and arrows of outrageous fortune, Or to take arms against a sea of troubles And by opposing 2 end them. …
Fig. 1Hamlet — Act 3, Scene 1

It’s intended to be useful in the creation of non-fiction works, particularly those on technical matters, such as learning a programming language, discussing complex concepts which benefit from detailed examples, and so on. Its focus is on simplicity, and meeting a set of common needs without complexity, at the expense of comprehensiveness.

Here’s an example of a more code-like style of annotation:

Fig. 2Demo of FigureMark
normal text inserted text removed text comment text with a reference 1 result of something text with reference 2.1 and a highlight

I wrote Python and Jekyll (Ruby) versions to get started with, so I can use it both with my publishing system and here on the blog.

I hope someone else will find it as useful as I already have.