This is currently a work in progress, but I have a 0.1.0 release of a “One Ring To Rule Them All” Markdown processor published.
The goal of Apex is to make it possible to write in any Markdown processor’s syntax, be it Kramdown (with IALs), MultiMarkdown (with v6 extensions), CommonMark (with GFM extensions), or any syntax that uses parts of those processors. Apex defaults to a unified mode that combines the features of all of these, automatically adjusting to the syntax it finds.
Where CommonMark is strict, Apex aims to be very permissive. While I advocate for clean, clear Markdown, you shouldn’t have to worry whether the Markdown you wrote for GitHub is going to work on your blog, or whether syntax you used in Marked is going to work when you export from the command line.
Speaking of Marked, yes, the ultimate goal of Apex is to have a Markdown processor option in Marked that’s essentially universal. It will default to Apex and the user won’t have to question why their Markdown from Obsidian isn’t working in Marked, and I won’t have to explain the differences between the processors anymore. Apex has a ways to go before it’s stable enough for production integration like that, but it’s already not far off. But I’m also open sourcing it, so please feel free to contribute (any code contributors will be named in Marked’s credits when it’s integrated). Even if that just means filing Issues, any help making this bulletproof is appreciated.
I’ll do a separate announcement of the Marked 3 public beta soon, but you can join now if you head over to markedapp.com.
I’ve set up a GitHub repo, and a pretty complete wiki for the project. It details installation, usage, syntax, and more.
Some of the special features include:
Use ^ to break consecutive lists
to break consecutive lists Use Marked, MultiMarkdown, or iA Writer syntax to include external files automatically detects images, source code, and Markdown files and inserts the correct formatting if a CSV file is included, it’s converted to a table
Marked and Leanpub pagebreak syntax, which can be styled to create page breaks in print and PDF
... continue reading