RSS Feeds

SimplePage can generate an RSS feed at /rss.xml when at least one page opts in with frontmatter. Feed items are created from markdown frontmatter and page content, so the frontmatter values you set are exactly what appears in the feed.

Enable RSS for a Page

Add frontmatter at the very top of the page. RSS items are only created when rss: true is present and the page has a created timestamp.

---
title: My First Post
description: A short summary for RSS readers
created: 2026-01-29
updated: 2026-02-05T10:00:00Z
rss: true
tags:
  - tutorial
  - intro
---

RSS Frontmatter Fields

Only lowercase keys are parsed. These fields affect RSS generation:

  • rss: Must be true to include the page in the feed.
  • created: Required for RSS items. Must be an ISO date or datetime string.
  • title: Used as the RSS item title. Defaults to your domain name when missing.
  • description: Used as the RSS item description. Defaults to an empty string when missing.
  • updated: Optional ISO date or datetime string. Used for atom:updated and dc:modified.
  • tags: Optional categories. Use a YAML list or a comma-separated value.
  • language: Only read on the root page to set the feed language (defaults to en).

Feed Metadata

Channel data comes from the root page frontmatter:

  • title: Used as the feed title.
  • description: Used as the feed description. Defaults to A SimplePage by <domain>.
  • language: Defaults to en if not set.

The RSS feed is available at /rss.xml, and /feed redirects to it.

Item Content and Media

  • The RSS item link is your page URL under https://<domain>.link.
  • The item content is the rendered HTML body of the page.
  • The first markdown image or embed (![alt](url)) is inspected for media.
  • Audio, video, and PDF URLs become <enclosure> entries; images are left in content:encoded only.
  • Relative media URLs are converted to absolute URLs using your site domain.
  • Because audio links become <enclosure> entries, you can publish podcast episodes by embedding an MP3 in the post body.

Limits and Ordering

  • Items are sorted newest to oldest by created date.
  • The feed includes up to 30 items.
  • The feed stops adding items once it reaches about 2MB.

< Prev (Customize Appearence) ・ Next (Safe Multisig Support) >