Technical previewShare feedback
Livemark
LivemarkMarkdown site generator

Open source · MIT License

Markdown
site generator
without limits.

Organise your Markdown however you like, then customise as far as you want: swap in your own React components, restyle with Tailwind and add TanStack Start pages. Docs, a blog and a changelog come built in.

A Livemark docs page with a sidebar, a highlighted code block and a table of contents

Written in plain Markdown

docs/code-blocks.md
---
title: Code Blocks
---
```ts title="livemark.config.ts"

Stays out of your way

No required folder structure, no lock-in. Livemark adapts to your repo, not the other way round.

  • Any file layout

    Point include globs at the Markdown you already have. README, CONTRIBUTING and CHANGELOG become pages too.

  • Real TanStack Start pages

    Drop a .tsx file into .livemark/routes/ for pricing, dashboards or anything else. This landing page is one.

  • Tailwind, fully customizable

    Built on Tailwind v4 and shadcn-style primitives. Restyle with CSS tokens, use utilities in your own pages, or escape any component under .livemark/.

your-repo
.livemark/
└─ routes/
   ├─ pricing.tsx
   └─ dashboard.tsx
guides/
├─ setup.md
└─ faq.md
src/
README.md
CHANGELOG.md
livemark.config.ts

Beautiful by default

Rich Markdown, a polished mobile experience and sensible defaults. Customize only what you want.

Shiki syntax highlighting

100+ languages, Catppuccin themes, diffs, line highlights, and TwoSlash type hints out of the box.

Diagrams & math

Mermaid flowcharts and KaTeX equations, theme-aware, zero config. Just write them in your Markdown.

Rich Markdown syntax

Callouts, tabs, steps, cards, file trees and badges as plain directives — and MDX components when you need more.

Multi-language sites

Translate any page with a sibling file. Bundled UI strings for 7 languages, a language picker and hreflang tags.

Perfect on mobile

Bottom-sheet navigation, page contents a tap away, and no sideways scroll on any phone.

Docs, blog & changelog

Multiple content sections with tags, dates, and auto-generated index pages, all from configuration.

Search & navigation

Orama full-text search, per-section sidebars, keyboard shortcuts, and smart table-of-contents.

Dark mode & theme tokens

Built-in dark mode, light/dark image variants, CSS variables like --primary, and swappable Shiki themes.

Instant preview, static output

Edits show up in the browser as you save, no reload. Then a static build with sitemap, robots and RSS.

Write Markdown. Ship a website.

Your .md files stay as they are — Livemark does the rest.

quickstart.md
---
title: Quickstart
icon: rocket
---

# Quickstart

Install the package:

```bash
npm install livemark
```

:::tip
Run livemark dev and open the browser.
:::

## Features

- **Fast** rebuilds with Vite
- **MDX** components when you need them
- _Beautiful_ out of the box
rendered

Quickstart

Install the package:

npm install livemark
TIP

Run livemark start and open the browser.

Features

  • · Fast rebuilds with Vite
  • · MDX components when you need them
  • · Beautiful out of the box

Ready for AI agents

Every build publishes your site in the formats AI agents look for, alongside the HTML for people. No configuration needed.

terminal
$ curl -H "Accept: text/markdown" \
    livemark.dev/introduction/

HTTP/2 200
content-type: text/markdown

# Introduction

> Learn how to set up your
> first Livemark project.

## What you get

- **Just write Markdown.**
  GitHub-flavored Markdown works out
  of the box, with footnotes and gemoji.

:::tip
Every page has a twin like this one —
list them all at /llms.txt.
:::
  • A Markdown twin of every page

    Each page gets an index.md beside its HTML, linked from the page head. One CDN rule serves it to requests that send Accept: text/markdown.

  • llms.txt out of the box

    An llms.txt index of every twin, grouped by section and advertised in a Link header on the home page.

  • Content signals

    robots.txt states whether your pages may be used for search, AI answers or model training. One config option changes it.

  • Agent skills

    Point skills at your SKILL.md files and they are published under /.well-known/agent-skills/.

  • Skills for your coding agent

    npx skills add https://livemark.dev teaches Claude Code, Cursor or Codex to write, configure and customize your Livemark site.

Your website, Livemark's Markdown

Already have a Vite and React app? Render Markdown in it with the same pipeline and components, without adopting Livemark itself.

  • One Vite plugin

    Add @livemark/vite and import any .md or .mdx file as a React component, with its frontmatter and table of contents.

  • The same components

    Callouts, tabs, cards, Shiki code blocks, Mermaid and KaTeX render exactly as in a Livemark article. Swap any of them for one render.

  • Styled by your Tailwind

    One @import brings the Markdown styles into your Tailwind v4 build, themed by your own tokens.

vite.config.ts
import markdown from "@livemark/vite"
import { defineConfig } from "vite"

export default defineConfig({
  plugins: [markdown()],
})
routes/blog/post.tsx
import Post from "./post.md"

export function PostPage() {
  return <Post />
}

Start writing. Let Livemark handle the rest.

Point Livemark at the Markdown you already have, add pages when you need them, deploy. That's the whole setup.