Technical previewShare feedback

Docusaurus vs Livemark

Updated Nov 10, 2026

Docusaurus is an open-source docs framework maintained by Meta. It renders React + MDX content through a Webpack-based build pipeline, ships first-class versioning and internationalization, and has a large plugin ecosystem.

At a glance

AxisLivemarkDocusaurus
Language / runtimeTypeScript / Node 24+TypeScript / Node 18+
UI frameworkReact 19React 18
Build toolVite + TanStack StartWebpack
Content formatMarkdown + MDXMarkdown + MDX
LicenseMIT, self-hostedMIT, self-hosted
Output modelPrerendered static (SSR-capable)Prerendered static

Architecture

Livemark wraps Vite, TanStack Start, and React into a single zero-config CLI. Content is loaded from globbed .md files, compiled as Markdown, or as MDX for .mdx files, at build time, and prerendered to static HTML for every route.

Docusaurus is built on Webpack. The runtime is React Router + a Docusaurus core that handles theming, plugins, and content sources. Plugins are first-class — every built-in feature (docs, blog, pages, search) is itself a plugin, and third parties extend the system the same way.

Content layout is unconstrained on the Livemark side: it scans by glob (include/exclude in livemark.config.ts), and each article's URL follows the file's place below its include glob unless a path: frontmatter field sets it. There's no required docs/ folder — a project can pull articles from README.md, docs/, blog/, package READMEs, or anywhere else. Docusaurus's docs plugin expects a docs/ directory (configurable via path, but folder-based rather than glob-based).

Content surface

Both tools accept Markdown and MDX with frontmatter. Both let you embed React components inside .mdx files.

Livemark's directives (:::card, :::tip, :::tab, …) are compiled by textlane, the Rust Markdown pipeline Livemark runs. Docusaurus uses MDX components plus an admonition extension for callouts.

Frontmatter shape differs: Livemark uses path, order, icon, sidebar, date, tags. Docusaurus uses id, slug, sidebar_position, sidebar_label, tags.

Feature matrix

CapabilityLivemarkDocusaurus
VersioningPartial (sections or per-branch deploys)Yes (built-in)
Internationalization (i18n)Yes (built-in)Yes (built-in)
SearchYes (Orama, client-side)Algolia DocSearch integration
BlogYes (built-in section type)Yes (built-in plugin)
ChangelogYes (section type, splits by version heading)No (community plugins)
SitemapYesYes
RSSYes (per blog section)Yes (for blog plugin)
ThemesComponent overrides via .livemark/Theme packages (@docusaurus/theme-*)
PluginsVite plugins + textlaneFirst-class plugin API
Custom routes.livemark/routes/ (TanStack Router)Plugin-defined routes

Output & deployment

Livemark prerenders every route to disk at .livemark/build/client/ — see Deployment for host-specific guides.

Docusaurus also prerenders to static HTML, output at build/. The static output works on any of the same hosts (GitHub Pages, Cloudflare, Vercel, Netlify, static hosting). Docusaurus's built-in i18n produces separate output trees per locale.

See also

Created with ❤ and Livemark