The document Word should have been.
folio is the complete office suite in one plain-text file: tables and embedded datasets, charts, Python, diagrams, equations, drawings, 3D models, music, and slides. Write reports where the numbers live in the document and calculate as you type, the page looks finished from the first word, and the file is plain text that anyone can read — today, and in twenty years.
Try it in your browser · Install on Linux, Windows or macOS · See the examples
Your data lives in the document. A table in folio is a real dataset: typed columns, units, and formulas that recalculate as you edit. Charts are drawn from those tables, so when a number changes, every total and every chart that depends on it changes with it. No pasting screenshots of spreadsheets, no figures that quietly go out of date.
Beautiful without trying. You write headings, paragraphs, tables and charts; a theme decides the fonts, colours, table rules and chart palette. There are ten themes, each with a dark mode, and switching theme restyles the whole document at once. Print or export to PDF and it looks like a report, not a web page.
A file you own. A folio document is one plain Markdown file. Open it in any text editor, read it on GitHub, keep it in Git, diff it, search it. No binary format, no account, no lock-in — and folio itself is open source under the MIT licence. Documents render fully offline.
- Tables and datasets (embedded spreadsheets) — a plain Markdown table that GitHub shows as is, or a dataset with typed columns, units and formulas across rows and tables. One click turns one into the other.
- Beautiful charting — bar, line, area, scatter, pie and donut, with several series, stacked or grouped; filter and sort them with the same expressions as formulas. Or write a full Vega-Lite chart over your data.
- Run Python in the document — a
pythonfence withdata=@salesandout=fitreads your datasets and publishes results back as tables, values and chart sources, all offline in a sealed worker. Regressions, statistics, anything Pyodide's standard library gives you — calculations way beyond what charting can express. - Diagrams and equations — Mermaid and Graphviz diagrams, LaTeX maths, highlighted code.
- Drawings and 3D models — hand-written SVG; parametric JSCAD models you can export as STL.
- Music and audio — ABC notation and Strudel live-coding patterns played in the page; audio recorded from the microphone or embedded.
- Images — embedded in the document itself, so the file stands alone.
- Simple formatting, zero hand-styling — ten themes (each with a dark mode) decide fonts, colours, table rules and the chart palette. Print or export to PDF and it looks like a report, not a web page.
- Present as slides — one click plays any document as a deck: each H2 is a full-screen slide, with speaker notes on a separate presenter window so the projector stays clean. The file is still plain Markdown.
- An open standard underneath — one plain Markdown file, plus a section browser and a command palette (Ctrl+K) that finds every action by the words you already use.
This is a live dataset and a chart in a folio document — readable, and diffable, by anyone:
::: table {#budget}
caption: "Launch budget"
columns:
- {name: item, type: text}
- {name: cost, type: number, unit: "£k"}
- {name: share, type: formula, expr: "cost / (self.col.cost | sum())", format: percent}
data:
- [Engineering, 30]
- [Design, 12]
- [Marketing, 9]
:::
::: chart {#budget-chart}
source: @budget
query: {select: [item, cost]}
type: donut
:::And a compute block, still plain text — Python reads the dataset and publishes a fitted trend back into the document:
```python data=@takings out=fit,slope
xs = takings.col("day")
ys = takings.col("takings")
n = len(xs)
mx = sum(xs) / n
my = sum(ys) / n
slope = round(sum((x - mx) * (y - my) for x, y in zip(xs, ys)) / sum((x - mx) ** 2 for x in xs), 2)
intercept = my - slope * mx
fit = [{"day": x, "trend": round(intercept + slope * x, 1)} for x in xs]
```Everything else — headings, lists, links, ordinary tables — is the Markdown you already know.
| folio | Word / Google Docs | Notion | Obsidian | Jupyter / Quarto | |
|---|---|---|---|---|---|
| Tables that calculate, in the document | ✓ | basic | partly | plugins | ✓ (code) |
| Charts drawn from the document's own data | ✓ | embedded sheets | partly | plugins | ✓ (code) |
| Polished output with no styling by hand | ✓ (themes) | manual | fixed look | themes | templates |
| Plain-text file you can read anywhere | ✓ | — | — | ✓ | ✓ |
| Works offline, no account | ✓ | partly | — | ✓ | ✓ |
| No code to run | ✓ | ✓ | ✓ | ✓ | — |
| Python over the document's own data, offline | ✓ (optional) | — | — | — | ✓ |
| Present as slides, with speaker notes on your own screen | ✓ | slides mode | — | — | — |
Open any of these in the web version (Ctrl+K, then "example"):
- Q3 Sales Review — regions, product mix and targets as live charts, a heatmap, and the sales pipeline as a diagram.
- Quarterly review deck — the same report as a slideshow: press play and each section becomes a slide, with a presenter view for your notes.
- Coffee forecast — a Python compute block fits a trend to the data and projects it, published back into the document as a table and chart.
- Bracket design review — a variants table driving a 3D model, mass against stiffness, a dimensioned drawing and a requirements trace.
- A practice journal — a practice log charted week by week, and sheet music you can play.
- Management accounts, Signals and spectra, A technical paper, and more.
Try it first in your browser: https://tinpotnick.github.io/folio/ — open and save files on your own computer; nothing is uploaded. Install it as an app (Chrome/Edge: ⋯ → Install folio) and .md files can open with folio straight from your file manager, like the desktop app.
Flatpak — any distribution, sandboxed, updates with your system: Install folio (opens in GNOME Software or KDE Discover), or in a terminal:
flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak remote-add --user --if-not-exists folio https://tinpotnick.github.io/folio/repo/folio.flatpakrepo
flatpak install --user folio io.github.tinpotnick.folioFedora (and other dnf-based systems) — dnf upgrade keeps it current:
sudo dnf config-manager addrepo --from-repofile=https://tinpotnick.github.io/folio/repo/folio.repo
sudo dnf install folioDebian and Ubuntu — apt upgrade keeps it current:
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://tinpotnick.github.io/folio/repo/folio-archive-keyring.gpg \
| sudo tee /etc/apt/keyrings/folio-archive-keyring.gpg > /dev/null
curl -fsSL https://tinpotnick.github.io/folio/repo/folio.list \
| sudo tee /etc/apt/sources.list.d/folio.list > /dev/null
sudo apt update && sudo apt install folioOr download the .AppImage, .rpm or .deb from the
latest release.
The repositories and packages are signed with folio's key,
fingerprint 6F82 66DF 93E2 5A83 AD43 E40B 089C 758D 9CB4 E587
(folio-archive-key.asc).
Download from the latest release:
the .msi or -setup.exe for Windows, the .dmg for macOS (Apple
silicon and Intel). The builds are not code-signed yet: on macOS,
right-click the app and choose Open the first time; on Windows,
choose More info → Run anyway if SmartScreen warns. Once installed,
folio appears in Open with for .md files; to make it the default,
run Ctrl+K → Open .md files with folio by default inside folio
(on Windows that opens Settings → Default apps, where you choose).
folio is young: expect rough edges, and please report them. Your documents are plain Markdown, so they stay readable whatever happens to folio.
npm install
npm run dev # the web app at http://localhost:5173
npm run dev:desktop # the desktop app (needs Rust and Tauri's system packages)Tests, the desktop toolchain, and how the project is organised are in CONTRIBUTING.md.
folio is free, and made in spare time. If it saves you time or makes your reports better, you can buy me a coffee ☕ — or star the repository and tell someone who writes reports.
MIT — see LICENSE. Bundled fonts, libraries and samples keep their own licences, listed in THIRD_PARTY_NOTICES.md. The optional Strudel live-coding player is AGPL-3.0 and is not part of folio's builds; folio offers to download it the first time you play a Strudel pattern.



