Search the site

Back to all posts
Guides

Welcome to Grimorio

A quick tour of this template: what's included, how it's meant to be used, and how to start writing your own posts.

On this page
  1. What’s included
  2. How to write

If you’re reading this, you’ve just set up Grimorio, a blog template built with Astro and designed for writing without fighting the tooling. This post is an example, like the other two that ship with it: delete them whenever you want and start with your own.

A tidy desk next to a window

What’s included

The idea is that the important things are solved from minute one, so you only worry about writing:

  • Two languages ready to go: English at / and Spanish at /es/, with a button to jump between them.
  • Search across the whole site with Ctrl / ⌘ + K.
  • Light and dark mode that follows your system preference.
  • Social images generated for every post, with no design work on your part.
  • SEO handled: sitemap, RSS, metadata, and structured data.

How to write

Each post is a Markdown file inside src/content/posts/. You create the file, fill in four fields at the top (title, date, language, and category), and write. For the version in the other language, reuse the same file name in the other folder and the language button will link the two for you.

Write first, tidy later. The template is here to remove friction, not to add steps.

Take a look at the Writing with Markdown post to see everything you can use inside a post, and change it all to your liking from src/site.config.json.

Grimorio
Grimorio / Grimorio

Guides, notes, and stories.