Blog format
Podcast
The podcast (Pro): podcast.md for the show and one file per episode in podcast/, with every property.
The podcast is part of the blog folder, with Pro: podcast.md for the show and podcast/<name>.md for each episode. Episodes are written, previewed and published in Write like posts. An episode's name is also its address: podcast/first-words.md is /podcast/first-words. Names use letters, digits, _ and -.
The show's page is /podcast, its feed (for Apple Podcasts, Spotify and every podcast app) /podcast.xml.
podcast.md#
| Property | Value |
|---|---|
title | Required. The show's name, up to 200 characters. |
author | Who makes it. |
owner_email | The address podcast directories may contact. |
cover | The cover image's address: a square JPEG or PNG, 1400 to 3000 pixels, as Apple Podcasts and Spotify ask. |
category | An Apple Podcasts category, such as Arts or Arts > Books. |
explicit | true or false. |
language | A code such as en or zh-CN. |
type | episodic (newest first) or serial (in order). |
copyright | Up to 300 characters. |
apple_url, spotify_url | The show's pages there, shown as listen links. |
new_feed_url | Where the show moved, when it leaves Bearletter. |
The body is the show's description.
podcast/<name>.md#
| Property | Value |
|---|---|
title | Required. Up to 300 characters. |
audio | Required to publish: the MP3 or M4A file's address in your media library. |
duration | 42:10, 1:02:15 or a number of seconds. |
episode, season | Numbers from 1. |
episode_type | full, trailer or bonus. |
explicit | true or false. |
image | The episode's own cover. |
transcript | A VTT or SRT file from your media library. |
guid | Kept from another host when the show moved here, so apps do not show episodes twice. |
published_date | 2026-10-02 or 2026-10-02 09:30, in the blog's time zone. A future date schedules it. |
publish | false keeps it a draft. |
meta_description | The summary in apps and search. Without it, the first paragraph is used. |
The body is the show notes.
Listing episodes on the blog#
Put ::podcast (or ::podcast{limit="5"}) in home.md or a page to list the latest episodes. See Components.
Bearletter · bearletter.com · Every page is also Markdown: llms.txt