Guides

Writing content

Léon styles plain Markdown, and adds content components written with the blocks syntax of Cecil.

On this page

Callouts

Callouts highlight information. Use :::note, :::info, :::tip, :::warning, :::danger or :::important:

:::tip
Organize your content in nested folders to build the sidebar.
:::

Tabs

Each #### heading starts a new tab. Tabs with the same label are synchronized across the page, and the choice is remembered.

macOS

Install with Homebrew:

brew install cecil

Windows

Install with Scoop:

scoop install cecil

Linux

Download the Phar:

curl -LO https://cecil.app/cecil.phar

Code groups

A code group shows alternative code blocks in a single frame:

macOS

brew install cecil

Windows

scoop install cecil

Linux

curl -LO https://cecil.app/cecil.phar

Without headings, tabs are named after the language of each block:

YAML

theme:
  - leon

JSON

{"theme": ["leon"]}

Steps

  1. Write

    Write your pages in Markdown.

  2. Build

    Run php cecil.phar build.

  3. Publish

    Deploy the _site folder anywhere.

Accordions

What is Cecil?

A static site generator, written in PHP, that turns Markdown files into a website.

Can I use HTML?

Yes, and a native <details> element is styled as an accordion too.

Cards

Nesting

A block can contain other blocks: its fence must then be longer than theirs (::::steps … ::::).

  1. Install

    Bash

    brew install cecil

    PowerShell

    scoop install cecil

  2. Configure

  3. Build

    Run cecil build.

Composer

composer require cecil/theme-leon

Archive

::::steps
#### Configure
:::tip
Add `leon` to the `theme` list of your site.
:::
::::

Code

Inline code, keyboard keys like Ctrl + K, and blocks with syntax highlighting:

<?php
// builds the site
$builder = Cecil\Builder::create($config);
$builder->build(['drafts' => false]);
{% for page in site.pages|sort_by_date %}
  <a href="{{ url(page) }}">{{ page.title }}</a>
{% endfor %}

Tables

What I want to do Best option
Search the documentation Press Ctrl + K
Read a page as Markdown Copy page → View as Markdown
Ask an AI assistant Copy page → Open in Claude

Diagrams

flowchart LR
  A[Markdown] --> B(Cecil)
  B --> C{Léon}
  C --> D[HTML]
  C --> E[Markdown]
  C --> F[llms.txt]

Quotes and lists

Simplicity is the ultimate sophistication.

  1. First item
  2. Second item
    • Nested item
    • Another one
  3. Third item