BearletterDocsllms.txtbearletter.comDashboard

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#

PropertyValue
titleRequired. The show's name, up to 200 characters.
authorWho makes it.
owner_emailThe address podcast directories may contact.
coverThe cover image's address: a square JPEG or PNG, 1400 to 3000 pixels, as Apple Podcasts and Spotify ask.
categoryAn Apple Podcasts category, such as Arts or Arts > Books.
explicittrue or false.
languageA code such as en or zh-CN.
typeepisodic (newest first) or serial (in order).
copyrightUp to 300 characters.
apple_url, spotify_urlThe show's pages there, shown as listen links.
new_feed_urlWhere the show moved, when it leaves Bearletter.

The body is the show's description.

podcast/<name>.md#

PropertyValue
titleRequired. Up to 300 characters.
audioRequired to publish: the MP3 or M4A file's address in your media library.
duration42:10, 1:02:15 or a number of seconds.
episode, seasonNumbers from 1.
episode_typefull, trailer or bonus.
explicittrue or false.
imageThe episode's own cover.
transcriptA VTT or SRT file from your media library.
guidKept from another host when the show moved here, so apps do not show episodes twice.
published_date2026-10-02 or 2026-10-02 09:30, in the blog's time zone. A future date schedules it.
publishfalse keeps it a draft.
meta_descriptionThe 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