# markpage

Last updated: 2026-10-27 06:04 UTC

> markpage is a free, open, web-based Markdown and LaTeX editor with live preview, KaTeX math, Mermaid diagrams, an AI writing assistant, real-time collaboration, and export to PDF, DOCX, EPUB, and HTML. It runs in any modern browser, works offline, and requires no account.

**One-line definition:** markpage is a free, browser-based Markdown and LaTeX editor that renders a live preview as you type and exports documents to PDF, DOCX, EPUB, and HTML. It is an open-source (MIT) alternative to Overleaf and Typora.

markpage is an open alternative to Overleaf and Typora for writing documents, notes, research papers, and technical content. It is built with React + TypeScript, organized into domain modules under `src/modules/`, and deploys to Vercel serverless functions. A detailed machine-readable reference is at https://markpage.app/llms-full.txt.

## Key features

- **Dual-mode editing**: CodeMirror-based Markdown and LaTeX editors with live, split-pane preview
- **LaTeX math**: real-time KaTeX rendering of inline (`$...$`) and display (`$$...$$`) math, plus a dedicated LaTeX document mode
- **Diagrams**: Mermaid (flowcharts, sequence, Gantt) and TikZ rendered in preview
- **AI assistant**: streaming chat (Vercel AI SDK), in-place content transform, image generation, and ghost text
- **Collaboration**: real-time presence, comments, and a review panel over Socket.IO
- **Export**: PDF, DOCX, EPUB, HTML, PNG, JPEG, plain text, and raw Markdown/TeX; publish to GitHub Gist
- **Document management**: version history, auto-save with conflict resolution, local backups, document library with tags and categories
- **Navigation**: table of contents sidebar with source-line syncing
- **Internationalization**: 12 languages (en, zh, ja, ko, fr, de, es, ru, pt, it, ar, he) with full RTL support
- **Accessibility**: WCAG 2.1 AA, keyboard-first, ARIA, screen-reader support
- **Offline**: service worker, local-first storage
- **Dark mode**: system-aware with manual toggle

## Use cases

- Writing technical docs, READMEs, and API docs in Markdown
- Authoring research papers and math-heavy notes with LaTeX/KaTeX
- Creating shareable reports and exporting to PDF/Word
- Collaborative document drafting with AI assistance
- Embedding rendered documents in other sites via share links

## Quick start

- **Use it**: open https://markpage.app/ — no signup required
- **Self-host / develop**:
  - Requires [Bun](https://bun.sh)
  - `bun install`
  - `bun run dev` (Vercel dev with frontend + `api/` routes)
  - Build: `bun run build` (typecheck + Vite build to `dist/`)
- **Test**: `bun run test`

## Optional integrations

- OpenAI / Vercel AI Gateway API key for AI features
- DB-backed email/password auth (`AUTH_JWT_SECRET`) for authentication and cloud document sync
- Neon PostgreSQL (via `DATABASE_URL`) for the document library

## Links

- Website / app: https://markpage.app/
- Project documentation: https://markpage.app/ (in-app)
- llms-full.txt (complete reference): https://markpage.app/llms-full.txt
- Markdown syntax: https://www.markdownguide.org/basic-syntax/
- LaTeX math (KaTeX supported functions): https://katex.org/docs/supported.html
- Mermaid diagram syntax: https://mermaid.js.org/intro/

## Export formats

| Format | Notes |
| --- | --- |
| PDF | Styled layout, preserves math and diagrams |
| DOCX | Word document, image and table support |
| EPUB | E-book format |
| HTML | Self-contained HTML file |
| PNG / JPEG | Rendered image export |
| TXT / MD / TEX | Plain source export |

## Supported languages

English, Chinese (Simplified), Japanese, Korean, French, German, Spanish, Russian, Portuguese, Italian, Arabic, Hebrew. Arabic and Hebrew render right-to-left automatically.
