Formatting story text (markdown)

Text blocks in stories support markdown plus a few shortcodes. Content is sanitized for safety before display.

Markdown basics

  • Headings: lines starting with `#` through `######`
  • Bold with `text`, italic with `text`
  • Lists: `-` or `*` for bullets; numbered lists with `1.`
  • Links: `label` — URLs are restricted to http, https, and same-site paths
  • Images: `alt text` (same URL rules as links)
  • Blockquotes: lines starting with `>`
  • Fenced code: triple backticks for a code block

Shortcodes (custom embeds)

Use these on their own line or inline where noted:

  • `{{youtube:VIDEO_ID}}` — YouTube embed
  • `{{soundcloud:URL}}` — SoundCloud player (full SoundCloud URL)
  • `{{image:PATH}}` — Image from storage path (advanced)
  • `{{release:HANDLE}}` — Link stub to a release handle
  • `{{track:HANDLE_OR_ID}}` — Link stub to a track
  • `{{artist:HANDLE}}` — Link stub to an artist handle

For the full editing experience, see Writing stories with the Story Weaver.