Why wikitext
Wikven authors content in Wikitext, MediaWiki's markup, rather than Markdown. If you are coming from a Markdown-based site generator, here is what changes, and why you might want it.
What wikitext adds
- Templates — reusable, parameterised snippets transcluded with
{{...}}. Markdown has no equivalent; you copy and paste instead. See Pages#Templates. - Parser functions and magic words — light logic and computed values (
{{#if:}}, dates, page info) written in the page itself. - Structured linking —
[[Page]]internal links, categories and redirects, managed by the wiki rather than by hand. - Rich media and references — image thumbnails and galleries and footnotes in one consistent syntax.
- An extension ecosystem — syntax highlighting, math and more, added as extensions.
- One definition — wikitext is whatever MediaWiki's parser makes of it, so a page renders the same wherever it is parsed. Markdown is less standardised than it looks: CommonMark pins down a core, but GitHub Flavored Markdown and tool-specific variants (such as Phabricator's Remarkup) render the same text differently.
What Markdown does better
- Simplicity — a smaller, more readable syntax with a gentler learning curve; wikitext's tables and template calls in particular take longer to pick up.
- Ubiquity — Markdown is supported almost everywhere and familiar to most writers, so contributors usually arrive already knowing it.
- Tooling — editors, formatters and linters for Markdown are plentiful and mature; the equivalents for wikitext are thinner outside a wiki.
- Lightweight rendering — Markdown renders with a small library, whereas wikitext normally needs MediaWiki itself.
Where Wikven fits
That last cost, running MediaWiki, is the one Wikven removes: it renders your wikitext through MediaWiki once, at build time, and ships plain static HTML. You get templates, parser functions and the rest with nothing to run in production. Reach for Wikven when that trade is worth it, typically when your content is already wikitext, or when templates and transclusion would save real work.