Mathew — a wiki for mathematics

A modern math-concept wiki. Articles are written in Markdown (with LaTeX via KaTeX) and stored in MongoDB through an Express API.

mathew/
├── backend/    Express 5 + Mongoose API (port 5000)
└── frontend/   Nuxt 4 wiki UI (port 3000/3001)

Quick start

# 1. API (requires MongoDB on localhost:27017)
cd backend
npm install
npm run seed     # optional: 6 sample articles (LaTeX included)
npm run dev      # → http://localhost:5000

# 2. UI
cd ../frontend
npm install
npm run dev      # → http://localhost:3000

Pages

Route	What it does
`/`	Search + recently updated articles
`/wiki/<slug>`	Rendered article with table of contents
`/wiki/<slug>/edit`	Markdown editor with live preview
`/new`	Create a new article

Markdown + LaTeX

Articles support GitHub-ish Markdown (headings, tables, lists, blockquotes, fenced code with highlighting) plus LaTeX: $E = mc^2$ inline and $$ ... $$ in display mode. Rendered server-side with markdown-it + markdown-it-texmath + KaTeX and sanitized with DOMPurify (raw HTML in articles is escaped).

Handy macros: \R, \N, \Z, \Q, \C for the number sets.

API

Method	Endpoint
GET	`/api/articles?q=&tag=` — search / filter, no content body
GET	`/api/articles/slug/:slug` — one article
POST	`/api/articles` — create (`title` required; slug auto-generated & uniquified)
PUT	`/api/articles/slug/:slug` — update
DELETE	`/api/articles/slug/:slug` — delete

Configuration

Where	Variable	Default	Meaning
`backend/.env`	`PORT`	`5000`	API port
`backend/.env`	`MONGO_URI`	`mongodb://127.0.0.1:27017/mathew`	Mongo connection
`frontend` env	`NUXT_PUBLIC_API_BASE`	`http://localhost:5000`	Where the UI calls the API

Editing tips

/ focuses the search box on the home page; Ctrl/Cmd+S saves in the editor.
The editor has Write / Split / Preview modes; LaTeX and code highlight update live.
Changing an article's title may change its slug (old links 404 — redirect not implemented).

2.1 KiB Raw Blame History