# Blog posts

Adding a blog to your Retype website is as quick as adding a new .md file to your project.

Create a /blog/ folder in your project.

Create a new .md file using the format YYYY-MM-DD-title.md with that specific date format as the filename prefix:

/blog/2025-11-15-hello-world.md

# Hello World

This is my first blog post built with Retype.

Run retype start and your blog is live at /blog/.

Retype automatically handles the rest:

A summary page is generated at /blog/
An RSS feed is created
Each post gets Newer and Older navigation buttons
Posts are sorted by date, newest first

The date in the filename sets the publish date. You can also set or override the date using the date frontmatter property.

# Latest Post

Use the Retype templating engine to dynamically render a Card linking to your most recent blog post:

[!card]({{ content.blog.posts[0].filePath }})

release

What's New in Retype v4.0

Retype v4.0 is here! This major version release brings powerful new components, expanded templating capabilities, and a complete upgrade of all internal libraries and dependencies. Your existing projects will work exactly as before, just faster and with a pile of new powerful features for all Retype users.

2026-02-23

# Three Posts

Combine a for loop with vertical cards to display your three most recent posts:

{{ for post in content.blog.posts | array.limit 3 ~}}
[!card vert]({{ post.filePath }})
{{ end }}

release

What's New in Retype v4.0

2026-02-23

release

What's New in Retype v3.12

Retype v3.12 brings powerful new features for content discovery, visual design, and theme customization. This release introduces the Backlinks component for Retype Pro, automatic dark mode image switching, color preview chips, enhanced page descriptions, and comprehensive theming improvements.

2026-02-10

release

What's New in Retype v3.11

Retype v3.11 puts you in control of your project's visual identity, while keeping everything fast, clean, and easy to use. This release brings Pro-level theme customization, smarter navigation, and faster syntax options to help you create documentation that feels more like your own.

2025-07-02

# Blog summary page

The /blog/ folder can include a blog.md (or index.md) file to customize the blog summary page heading or add introductory content above the post listing.

/blog/blog.md
# Company Blog

# Frontmatter

Blog posts support all standard page configuration options. A few are especially useful for blog posts:

---
author: Jane Smith
category: [announcements]
tags: [release, update]
---

# author

Set one or more authors for the post. Accepts a simple name, email, or a full author object with name, email, link, and avatar properties.

---
author: Jane Smith
---

---
authors:
  - name: Jane Smith
    email: jane@example.com
    link: https://github.com/janesmith
  - Bob Wilson
---

See the full author documentation for all options.

# date

A custom publish date in YYYY-MM-DD format. If set, Retype displays the date at the top of the post and uses it for ordering.

---
date: 2025-11-15
---

If no date frontmatter is set, Retype uses the date from the filename.

# category

Assign one or more categories. Retype automatically generates category summary pages at /categories/.

---
category: [announcements, engineering]
---

# Project configuration

The blog settings in your retype.yml file control the behavior of the blog summary pages.

retype.yml
blog:
  pageSize: 5
  maxResults: 100
  title: News
  base: news

# pageSize

The number of posts displayed per summary page. Default is 10.

blog:
  pageSize: 5

If the total number of posts exceeds the pageSize, Retype automatically generates paginated summary pages.

# maxResults

The maximum total number of posts included across all paginated summary pages. Default is unlimited.

blog:
  maxResults: 100

Posts beyond the limit are excluded from the summary but remain accessible by direct URL.

# title

A custom heading for the blog summary page. Default uses the locale translation.

blog:
  title: News & Updates

# base

The URL path segment for the blog. Default is "blog".

blog:
  base: news

Setting base: news generates the blog summary at /news/ instead of /blog/. Your blog post files still live in the /blog/ folder in your project source.

guide