Examples

Blog setup

1. Create posts

Put posts in content/blog/:

---
title: My First Post
layout: post
date: 2026-08-01
tags: [news, update]
---

# Hello World

This is my first blog post!

2. Create a blog index

content/blog.md (or content/blog/index.md):

---
title: Blog
layout: blog
description: News and updates
---

3. List posts in a layout

layouts/blog.njk using the posts collection:

{% extends "base.njk" %}

{% block content %}
<div class="max-w-4xl mx-auto">
  <h1 class="text-4xl font-bold mb-8">{{ title }}</h1>

  {% for post in collections.posts %}
  <article class="mb-8 pb-8 border-b">
    <h2 class="text-2xl font-bold mb-2">
      <a href="{{ post.url }}">{{ post.data.title }}</a>
    </h2>
    <time class="text-gray-600">
      {{ post.data.date | date('MMMM d, yyyy') }}
    </time>
    {% if post.data.description %}
    <p class="mt-2">{{ post.data.description }}</p>
    {% endif %}
  </article>
  {% endfor %}
</div>
{% endblock %}

Make sure simple.config.js defines the posts collection (it does by default):

collections: {
  posts: {
    pattern: 'blog/**/*.md',
    sortBy: 'date',
    reverse: true,
  },
},

Docs sidebar

This documentation site uses a docs collection sorted by order — see Collections for the pattern.