Sorry for boosting my own thread, but I added two examples of how to use md in the wild.

One is about how to extend the existing syntax, another one is about how to create a syntax from scratch. See tests for how it works. Cheers.

One might pass State to Md.parse/2 as a second parameter. Starting with v0.7.0 it has payload key.

All the listener functions can return a tuple {:update, new_state} to update the state.

Yes, you might explicitly allow whatever you want to be parsed as markdown, including but not limited to the markdown syntax itself. E. g. magnet allows to declare a syntax for @handles and/or #hashtags.

I am reading your code, it is very impressive. It is basically a framework to build ad-hoc parsers for any syntax. For example, you can have a syntax highlighter for any program languages. A server side rendering, elixir based syntax highlighter will be very sweet. I long for the day when I could remove prismjs from my js bundle. Keep it up!

There‘s already GitHub - elixir-makeup/makeup: Syntax highlighter for Elixir inspired by Pygments