> Documentation index: https://pholio.lukaloehr.com/docs/llms.txt, a list of every page in this documentation.

# Pholio

> Beautiful documentation, powered by Markdown. One polished theme, fast search, zero dependencies.

Pholio turns a folder of Markdown files into a finished documentation site:
static HTML, one stylesheet, a few small JavaScript modules, the fonts and a
search index. No Composer, no npm, no framework, no build server. PHP runs once
at build time and is never needed again.

There is one theme, and it is polished down to the details: light and dark
schemes, a sidebar with collapsible folders, a table of contents that follows
you, keyboard shortcuts and instant search. You write Markdown; Pholio takes
care of the rest.

> **Info:** Status
>
> Pholio 0.1.0 builds complete documentation sites. What comes next is on the
> [roadmap](https://pholio.lukaloehr.com/docs/roadmap.md).

## What you get

- [Markdown in, HTML out](https://pholio.lukaloehr.com/docs/content-format.md): A strict Markdown subset plus a few declarative component tags. Anything unrecognized stops the build.
- [Components](https://pholio.lukaloehr.com/docs/components.md): Callouts, cards, tabs, steps, accordions, file trees, type tables and highlighted code, each shown with its source.
- [One configuration file](https://pholio.lukaloehr.com/docs/configuration.md): Title, logo, navigation, start page, palette, search, redirects, profiles. Plain PHP data, validated before the build.
- [Ready for agents](https://pholio.lukaloehr.com/docs/agents.md): Markdown for every page, llms.txt, skill.md and content negotiation, generated from your content.
- [Search without a backend](https://pholio.lukaloehr.com/docs/configuration.md#search): An index built at compile time and ranked in the browser, with typo, prefix and umlaut matching.

## What it deliberately is not

Pholio does not read your source code. There is no docblock extraction, no API
reference generation, no expression evaluation in content. Your documentation
is written by you; Pholio renders it.

It is also not MDX. Component tags are data, not programs: they carry
attributes, they nest, and they can't import or execute anything. New tags are
registered in PHP, where code belongs.

## Related topics

- [Getting started](https://pholio.lukaloehr.com/docs/getting-started.md)
- [Content format](https://pholio.lukaloehr.com/docs/content-format.md)
- [Components](https://pholio.lukaloehr.com/docs/components.md)
- [Configuration](https://pholio.lukaloehr.com/docs/configuration.md)
- [Agents](https://pholio.lukaloehr.com/docs/agents.md)
- [Architecture](https://pholio.lukaloehr.com/docs/architecture.md)
- [Roadmap](https://pholio.lukaloehr.com/docs/roadmap.md)
- Next: [Getting started](https://pholio.lukaloehr.com/docs/getting-started.md)