v4.2
Powered by

# Blogging

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:

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

# 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.2

Retype v4.2 adds new RSS controls, customizable labels, new search indexing controls, Card component upgrades, and a few CLI updates that make publishing easier to fine tune. See the full Changelog and Feature Log for a detailed list of updates in the v4.2 release.

2026-03-10

# 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.2

Retype v4.2 adds new RSS controls, customizable labels, new search indexing controls, Card component upgrades, and a few CLI updates that make publishing easier to fine tune. See the full Changelog and Feature Log for a detailed list of updates in the v4.2 release.

2026-03-10
release
What's New in Retype v4.1

Retype v4.1 has been primarily a community-driven release shaped by suggestions and feedback from Retype users. A huge thank you to the Retype community for your contributions and ideas that made it into this release. This release delivers a completely redesigned search experience, Unicode icon support, and new blog layout options.

2026-03-02
blog
Self-hosting Obsidian Vault with Retype

If you use Obsidian, chances are you’ve thought about publishing your vault online. Maybe it’s a personal digital garden, a team knowledge base, or project documentation. Obsidian Publish is a great option, and if you prefer to self-host and have full control over where your site is deployed, Retype is worth a look.

2026-02-25

# Blog summary page

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

/blog/index.md
# Company Blog

This is our 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

# 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.

# layout

Set the default layout for all blog posts. Default is blog. To include the left sidebar tree navigation and the right-side table of contents, set layout: page.

blog:
  layout: page

# maxResults

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

blog:
  maxResults: 100

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

# 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.

# title

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

blog:
  title: News & Updates

# rss

Use the blog.rss settings in your retype.yml file to customize the generated RSS feed metadata.

blog:
  rss:
    title: News & Updates
    description: Product announcements, release notes, and updates
    copyright: "© Copyright . All rights reserved."

See the blog.rss project configuration documentation for the full list of RSS settings.

guide