Programming

djot for text markup. It addresses a lot of the issues in Common mark (and of course far more of the issues of Markdown).

I'd like something akin to XML DOM for config files, but not XML.

The one benefit of binary config (like the Windows Registry) is that you can make a change programmatically without too many hoops. With text files, you have a couple of choices for programmatic changes:

• Don't
• Parse it, make the change, and rewrite it (clobbering comments and whitespace that the user setup; IIRC, npm does this)
• Have some kind of block that says "things below this line were automatically set and shouldn't be touched" (Klipper does this)
• Have a parser that understands the whole structure, including whitespace and comments, and provides an interface for modifying things in place without changing anything around it (XML DOM)

That last one probably exists for very specific formats for very specific languages, but it's not common. It's a little more cumbersome to use as a programmer--anyone who has worked with XML DOM will attest to that--but it's a lot nicer for end users.

I like the Doxygen's implementation and extension of Markdown. Pair it with PlantUML and you have something worth being a standard.