TileDown

---
title: TileDown
description: A Swift static site generator that typesets TeX math to static SVG at build time — pure Swift, no LaTeX toolchain, one engine shared with a PDF generator.
image: /assets/site-preview-light.svg
imageDark: /assets/site-preview-dark.svg
latest: true
---
# TileDown

A Swift static site generator that renders math, charts, and source-code color at
**build time** — in pure Swift, with no client-side JavaScript for those surfaces,
no web fonts, and no external toolchain: no LaTeX install, no `dvisvgm`, no C
libraries. The same engine typesets to PDF. Write ordinary Markdown; get a fast,
self-contained page.

[Get TileDown on Codeberg](https://codeberg.org/TileDownHQ/tile-down)

Install with Homebrew (Apple Silicon, macOS 14 or later):

```sh
brew install tiledown/tap/tiledown
tiledown build-site content/ dist/
```

Or build from source:

```sh
git clone https://codeberg.org/TileDownHQ/tile-down.git
swift run --package-path tile-down/Packages tiledown build-site content/ dist/
```

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

That equation is static SVG: view source and there is no script tag and no font
request for it. TileKit turns constrained Markdown into static HTML, CSS, JSON, and
feeds, with browser JavaScript only for interactive tiles.

Source code: [codeberg.org/TileDownHQ/tile-down](link:repo).

This website is generated by the project it describes. The source lives under
`Website/content`, and the build command is the same `tiledown build-site` command
documented for users.

:::tile callout
title: Built by TileDown
body: The live site is generated from Markdown folders, a built-in layout, the system theme, typed tiles, tag pages, and an RSS feed.
:::

## Try a local tile

The counter below is not server-backed. It is a typed tile that renders HTML,
theme-aware CSS, and browser JavaScript scoped to this page.

:::tile counter
label: Count a local tile
:::

## What the demo covers

| Surface | Live coverage |
|:---|:---|
| Markdown profile | headings, links, images, tables, lists, code, block quotes |
| Source code | build-time syntax highlighting for 19 language profiles |
| Typed tiles | `callout`, `counter`, `embed`, and `newsletter` render in this site |
| Site model | folder routing, navigation, shared stylesheet, assets |
| Writing flow | canonical formatting, JSON output, help, and doctor checks |
| Publishing flow | Pages artifact workflow builds from source on Linux |
| Content model | posts, tags, latest posts, RSS, drafts, slug overrides |
| References | `page:`, `post:`, `tag:`, `social:`, and `link:` references |

See the [](page:features) for a page that exercises the visible behavior, or
open the [repository](link:repo) to inspect the implementation.

:::recent:::

## Status

TileDown is a developer preview, not a production static site generator yet. The
current engine and CLI are real enough to build this site, but project
scaffolding, watch mode, and production service hosting are
still on the road map.