# Folio

> Folio is a tool for writing presentations as text. Slides are written in a Markdown-inspired language with `:::` blocks, `{...}` attributes, themes and components, and rendered with a professional design.

## Getting started

- [Introduction](https://folioslides.com.br/docs/start/introduction.md): What Folio is, who it is for and how you turn text into presentations.
- [Quickstart](https://folioslides.com.br/docs/start/quickstart.md): Write your first slide and present it in five minutes.
- [Concepts](https://folioslides.com.br/docs/start/concepts.md): The building blocks of Folio, from projects and slides to automatic saving, history and the project theme.

## Guides

- [Writing slides](https://folioslides.com.br/docs/guides/writing.md): Headings, paragraphs, emphasis, links, lists, quotes, code, tables, images, comments and presenter notes.
- [Layout](https://folioslides.com.br/docs/guides/layout.md): Configure the slide, arrange content in columns, stacks, rows and grids, and place elements precisely.
- [Styling](https://folioslides.com.br/docs/guides/styling.md): Change colors, sizes, fonts, borders and shadows with attributes in braces, and create reusable styles.
- [Themes](https://folioslides.com.br/docs/guides/themes.md): Pick a built-in theme, adjust colors and fonts, and share definitions across the presentations in a project.
- [Header and footer](https://folioslides.com.br/docs/guides/header-footer.md): Write it once and repeat the same content, in the same place, on every slide.
- [Components](https://folioslides.com.br/docs/guides/components.md): Build reusable blocks with parameters, content and named slots to keep your slides consistent.
- [Step-by-step reveal](https://folioslides.com.br/docs/guides/reveal.md): Show a slide's content gradually, one block, item or phrase at a time.
- [Charts](https://folioslides.com.br/docs/guides/charts.md): Turn a table into a bar, line, area, pie or donut chart with the chart block.
- [Images](https://folioslides.com.br/docs/guides/images.md): Upload images to your project or use external addresses, adjust how they fit and use background images.
- [Presenting](https://folioslides.com.br/docs/guides/presenting.md): Present in full screen, use presenter mode with notes and a timer, and export your presentation as a PDF.
- [Version history](https://folioslides.com.br/docs/guides/history.md): Learn how automatic saving, automatic and named versions, restoring and conflicts between tabs work.
- [Library](https://folioslides.com.br/docs/guides/library.md): Keep themes, components, styles, palettes and templates to reuse across projects and share with other people.

## Reference

- [Syntax](https://folioslides.com.br/docs/reference/syntax.md): A quick reference to the whole Folio language, from document structure to escapes.
- [Attributes](https://folioslides.com.br/docs/reference/attributes.md): Every attribute the compiler accepts, with its values, scales and units.
- [Blocks](https://folioslides.com.br/docs/reference/blocks.md): Every built-in block in the language, with its form, content, own attributes and examples.
- [Built-in themes](https://folioslides.com.br/docs/reference/themes.md): Colors, fonts, sizes and styles of each built-in Folio theme.
- [Icons](https://folioslides.com.br/docs/reference/icons.md): How to use the built-in icons and the full list of available names.
- [Error messages](https://folioslides.com.br/docs/reference/errors.md): Every diagnostic code the compiler can emit, with its cause, an example and the fix.
- [Keyboard shortcuts](https://folioslides.com.br/docs/reference/shortcuts.md): Editor shortcuts, slash commands and the keys for presentation mode, presenter view and the audience screen.

## Optional

- [Full documentation in one file](https://folioslides.com.br/docs/llms-full.txt)