Our great sponsors
Free, open-source, cross-platform desktop Markdown text editor with live preview, string interpolation, and math.
KeenWrite is my text editor that takes a slightly different approach to MDX. Rather than include variable definitions within documents, variables are defined in an external file. I find that when variables are part of documents, those variables are often embed controls for presentation logic. To me, any presentation logic meant to affect a plain text document's presentation does not belong in the document itself. Part 8 of my Typesetting Markdown series shows the power of separating content from presentation by leveraging pandoc's annotation syntax.
Annotated Markdown is sufficiently powerful to produce a wide variety of different styles. Here are a few such documents typeset using ConTeXt:
What I do find bothersome is how some company's are setting de facto Markdown standards without considering the whole ecosystem. GitHub has done this by introducing the "``` mermaid" syntax, which creates a lot of problems.
: https://www.youtube.com/watch?v=u_dFd6UhdV8&t=18s (renamed afterwards)
:gem: A fast, open source text processor and publishing toolchain, written in Ruby, for converting AsciiDoc content to HTML 5, DocBook 5, and other formats.
I'm wondering that the article doesn't mention AsciiDoc with a single word. AsciiDoc is a perfect tool for complex text documents with tables, references, side notes etc. It is almost as easy as Markdown (if you compare only the features included in both), but offers way more possibilities. There are also good tools to convert it to different output formats like HTML and PDF.
A good starting point is: https://asciidoctor.org/
Static code analysis for 29 languages.. Your projects are multi-language. So is SonarQube analysis. Find Bugs, Vulnerabilities, Security Hotspots, and Code Smells so you can release quality code every time. Get started analyzing your projects today for free.
Pyblosxom file-based blogging engine
One minor note: jekyll definitely was not first to introduce front matter (though they may have introduced yaml front matter?).
I am sure that at least pyblosxom had it earlier: https://pyblosxom.github.io/Documentation/1.5/writing_entrie...
Here's the earliest surviving commit showing blog entry front matter in 2002: https://github.com/pyblosxom/pyblosxom/blob/f80cdb42eb37ee0e...
My recollection is that blosxom (a perl blogging engine) had front matter as well, but I can't find any evidence of it.
Good software/SaaS for Technical Documentation CMS
1 project | reddit.com/r/technicalwriting | 17 May 2023
Asciidoctor - A Writer's Swiss Army Knife
1 project | dev.to | 3 Jun 2022
Markdown as a Latex alternative for academic/math writing
1 project | reddit.com/r/Markdown | 3 Feb 2022
My failed attempt to use groff output.
1 project | reddit.com/r/pandoc | 13 Oct 2021
Git For Word Documents
2 projects | reddit.com/r/git | 9 Sep 2021