Despite the massive growth of docs-as-code as a documentation ethos, I continue to be surprised, year after year, by the lack of robust docs-as-code tools. Most days it feels as if docs-as-code was a giant standing on feet of clay, on the fragile toolchains that we use to create our documentation in all kinds of software companies, from startups to unicorns.
Markdown Is a Disaster: Why and What to Do Instead
Orgdown - the Interesting Feedback Phase so Far
Daydreaming a post-HTML Utopia
Orgdown - a New Lightweight Markup Standard for Text Documents
Markdown language comes in many flavors, some of which are better than others. Lightweight languages like AsciiDoc are easy to learn and extremely useful. Here's how it compares.
I really only ever make something when I want something to exist that doesn’talready, or when I want something that does exist to more readily suit...
My Emacs and Org-mode Workshops at the GLT26
dllup is a lightweight markup language designed for creating simple websites. It is a way to write an easily readable text file which the dllup parser turns into a static HTML page, or a LaTeX document. This document will cover the use of dllup to produce HTML webpages.
Org Mode Syntax Is One of the Most Reasonable Markup Languages to Use for Text