Let's consider the strengths and weaknesses of the choice of markdown in wikis generally, and for the Hitchhikers Project in particular.
# Strengths
- Readable as plain text; minimal cognitive load.
- Ubiquitous tooling across editors, CI, and hosting.
- Great with git: small diffs, easy reviews.
- Extensible via fenced code blocks and conventions.
- Works offline; resilient to tool churn.
- Easy preview in modern editors and browsers - markdownguide.org ![]()
# Weaknesses - Dialects exist; subtle incompatibilities (GFM vs others). See Flavours of Markdown. - Limited native semantics beyond headings/lists/links. - Complex layout and accessibility need care or HTML fallbacks. - Ambiguities (line breaks, nested lists) can surprise across renderers. - Tables and annotations are clumsy without extensions.