Blogin https://blogin.dev/ 2026-07-20T00:00:00Z Overview https://blogin.dev/guide/overview/ 2026-07-20T00:00:00Z Blogin is a static blog generator written in Raku. Point it at a directory of Markdown files and it produces a directory of plain HTML you can host anywhere. There is no database and no runtime:… blogin init https://blogin.dev/cli/blogin-init/ 2026-07-04T00:00:00Z Scaffold a new site in a directory, with a starter post, layouts, and a blogin.json. Getting Started https://blogin.dev/guide/getting-started/ 2026-07-19T00:00:00Z Install Raku and zef blogin new https://blogin.dev/cli/blogin-new/ 2026-07-01T00:00:00Z Create a new post file from a title, with front matter filled in and a slug derived from the title. Writing Posts https://blogin.dev/guide/writing-posts/ 2026-07-18T00:00:00Z A post is a Markdown file with a --- front matter block: --- title: My Post date: 2026-07-20 tags: [raku, web] description: A short summary. --- The body goes here. Run blogin new "My Post" to scaffold one with the front matter filled in. Reference links and footnotes Links can carry their target in a separate definition rather than inline. Write [text][label] in the body and define the label anywhere in the file: See [the home page][home] for more. [home]: https://example.com "Optional title" A collapsed form, [text][], uses the text as the label. Labels match case-insensitively, and an undefined reference is left as literal text. Footnotes use [^label] where the note is cited, with a matching definition: A claim that needs a source[^src]. [^src]: The cited source. Footnotes are numbered in the order they are first referenced and collected into a footnotes section at the end of the post, each with a link back to its reference. Reference and footnote definition lines never render as content. Sections The subdirectory a file sits in under content/ is its section, and the section is both the URL prefix and the layout selector. A file at content/posts/hello.md becomes /posts/hello and renders through layouts/posts/show.haml when present, otherwise layouts/show.haml. Nested directories become nested sections and nested nav entries. Summaries A listing and a feed entry show a short summary of each post rather than the whole body. Blogin picks the summary in this order: A summary in front matter, used verbatim. The text before a ` blogin build https://blogin.dev/cli/blogin-build/ 2026-07-03T00:00:00Z Render the content tree to static HTML, writing feeds, a sitemap, and the search index alongside the pages. Layouts https://blogin.dev/guide/layouts/ 2026-07-17T00:00:00Z Blogin renders pages with Template::HAML. A build wraps each post's rendered body in show.haml inside base.haml, and each section listing in index.haml inside base.haml. blogin serve https://blogin.dev/cli/blogin-serve/ 2026-07-02T00:00:00Z Build the site and serve it locally, rebuilding when content, layouts, static assets, data files, or the configuration change. A successful rebuild live-reloads the open page in the browser. Template Data https://blogin.dev/guide/template-data/ 2026-07-22T00:00:00Z Every layout renders against a context object. A method call in HAML is a call on that object, so = title runs the context's title method and - for posts iterates its posts collection. There are two… Data files https://blogin.dev/guide/data-files/ 2026-07-21T00:00:00Z A data/ directory beside content/ holds structured values that layouts read directly, so a list of authors, a set of social links, or a navigation table lives in one place rather than being repeated… blogin clean https://blogin.dev/cli/blogin-clean/ 2026-07-05T00:00:00Z Remove the output directory produced by a build, leaving the content, layouts, and configuration in place. CSS Frameworks https://blogin.dev/guide/css-frameworks/ 2026-07-16T00:00:00Z The HTML Blogin emits carries framework-specific classes drawn from a selected profile, set by the css-framework config key. The core renderer stays framework-agnostic: it asks the profile for a… Syntax Highlighting https://blogin.dev/guide/syntax-highlighting/ 2026-07-15T00:00:00Z Set "highlight": true in blogin.json and Blogin highlights fenced code during the build. Highlighting is server-side: there is no client JavaScript, and the pages work without it. Math and Diagrams https://blogin.dev/guide/math-and-diagrams/ 2026-07-21T00:00:00Z Blogin parses math and Mermaid diagrams into markup that a client-side renderer turns into equations and graphics. The build stays pure and static; the rendering happens in the browser. Feeds and Search https://blogin.dev/guide/feeds-and-search/ 2026-07-14T00:00:00Z Every build with at least one post emits feeds, a sitemap, and a search index. Metadata and SEO https://blogin.dev/guide/metadata-and-seo/ 2026-07-21T00:00:00Z Blogin emits per-page metadata for search engines and social cards, and a site-wide robots.txt, without any template work beyond a single call in the page head. Previewing and Building https://blogin.dev/guide/previewing-and-building/ 2026-07-13T00:00:00Z The preview server Configuration https://blogin.dev/guide/configuration/ 2026-07-12T00:00:00Z Site-wide settings live in blogin.json at the project root. Command-line options override the file. Internationalization https://blogin.dev/guide/internationalization/ 2026-07-21T00:00:00Z List the languages you write in and Blogin builds each into its own subtree. Themes and Plugins https://blogin.dev/guide/themes-and-plugins/ 2026-07-21T00:00:00Z Themes Deploying https://blogin.dev/guide/deploying/ 2026-07-11T00:00:00Z blogin build writes a self-contained public/ directory. Deploying is copying that directory to any static host.