Content

In atelier/_index.php, drop Markdown straight into the page — it's converted to HTML after PHP runs, so PHP variables and Markdown mix freely. Wrap the paragraph between an opening and a closing tag named markdown, the same way every paragraph on this tutorial page is written — view this page's source to see the real thing, since showing the tag's own angle brackets here would trip the very tag it's demonstrating.

Add a prose attribute on the opening tag to wrap the output in .prose — this site's own @kirigami/canva-based typography for long-form content.

notes/_notes.yaml:

                                        - title: The first pleat
                                          date: 2026-08-02
                                          excerpt: Where the studio's name actually comes from.
                                        - title: Paper weights, compared
                                          date: 2026-08-19
                                          excerpt: 80gsm folds crisp; 120gsm holds a curve.
                                    

notes/_index.php points a PHPDOC annotation at it, and gets the parsed data back as a plain array of objects — no manual file_get_contents() / yaml_parse():

                                        /**
                                         * @title Notes
                                         * @posts _notes.yaml
                                         */
                                    

                                        foreach ($posts as $post) {
                                            echo '<h3>' . str_htmlesc($post->title) . '</h3>';
                                            echo '<p>' . str_htmlesc($post->excerpt) . '</p>';
                                        }
                                    

Any annotation value ending in .yaml, .yml, .json or .md that resolves to a real file is loaded and parsed automatically — the string becomes structured data instead.

For a single note that's pure prose, skip writing PHP at all. notes/premier-pli/_premier-pli.md holds the text; the page file becomes almost nothing:

                                        /**
                                         * @title   The first pleat
                                         * @content _premier-pli.md
                                         */
                                    

@content renders that file's contents as the page body and skips executing the PHP file entirely — reserved for pages that are pure data or Markdown, wrapped by the same shared header/footer as everything else.