MarkDay

A local-first daily work logger with rich Markdown editing, calendar navigation, search, and math support. All data stays on your machine — no cloud, no accounts.

Features

Installation

pip install .

Or for development (editable install):

pip install -e .

Usage

markday                  # start on default port 5500, open browser
markday --port 8080      # custom port
markday --no-browser     # don't auto-open browser
markday --debug          # Flask debug mode

Set the data directory via environment variable:

MARKDAY_DIR=/path/to/notes markday

Data format

Entries are stored as plain Markdown in ~/.markday/YYYY.md:

# Mark Day 2026

## 2026-05-28

- Implemented FNO baseline on Burgers' equation
- Compared modes=12 vs modes=24: higher modes overfit on small dataset

## 2026-05-29

### Meetings

- Sync with team on neural operator paper

### TODO

- [ ] Run ablation on FiLM conditioning strength
- [x] Fix memory leak in DataLoader

Because the format is plain Markdown, you can edit files directly in any editor, commit them to git, grep them, or process them with any Markdown tool.

Keyboard shortcuts

Math examples

Inline: $E = mc^2$

Display:

$$
\int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
$$

Neural operator notation:

$$
\mathcal{G}_\theta : \mathcal{A} \to \mathcal{U}, \quad u = \mathcal{G}_\theta(a)
$$

Requirements

• Python ≥ 3.10
• Flask ≥ 3.0
• markdown ≥ 3.6
• pygments ≥ 2.17

All other dependencies (CodeMirror, KaTeX, highlight.js) are loaded from CDN.