Formatting your show notes
Your show notes are shown in a number of different locations, and depending on where they're shown, different kinds of formatting is supported. Pinecast aims to support the set of formatting options that are most broadly supported.
We aim to support major podcast apps as well as web browsers.
What podcast apps show
Simple text paragraphs and bulleted and numbered lists (without nesting) are all well-supported. Simple text formatting like bold and italic are usually supported, and the formatting disappears if they're not. Headings similarly are shown as plain text if they're not supported.
Tables, images, block quotes, code blocks, and other rich media features are not expected to work properly, and will likely be removed entirely.
To add links, we recommend always writing the link out as a full URL rather than hyperlinking text. Some apps may not support hyperlinks and just show the text.
When writing timecodes out like 00:12:34 Text , this is sometimes shown as a link to that timecode in certain apps. Pinecast websites will also make an attempt to link those timecodes in an adjacent player.
The editor
When you create an episode, there's an editor under the Show notes label on the New episode page. On desktop, this shows a toolbar with formatting options, the ability to toggle WYSIWYG for Markdown editing, and an option to show the editor full screen. On mobile, only a plain text field (accepting Markdown) is available. [link to 66]
Markdown that works
Markdown is a way to write out formatting for text without HTML code. However, because the formatting options available where show notes are visible are limited, we support only a limited subset of Markdown.
The features available to you:
- Blank lines between text starts a new paragraph.
- Surround text with double asterisks
**like this**to make it bold - Surround text with underscores
_like this_to make it italic - Hyperlinks can be written with the text inside square brackets and the URL inside parentheses
[like this](https://example.com), but be aware that some podcast apps may remove the link and show only the text. - Bulleted list items start with a hyphen and a space
- like this - Numbered list items start with a number, a dot, and a space
1. like this - Put two spaces or a backslash at the end of a line to create a line break
The following Markdown features do not work:
- Code written with backticks
- HTML tags between backticks remain as text, not as HTML
- Quotes, starting with
> - Images
HTML
Markdown allows the use of HTML. When you use HTML in your markdown, it must follow the rules of HTML on Pinecast. [link to article]
Pasting from word processors
When you copy and paste content from a word processor like Google Docs or Microsoft Word, we do our best to keep the formatting of the text that you copied. However, some features may be incompatible with Pinecast or your web browser, and that formatting or content is lost.
When pasting content from another app, always be sure to proofread that was pasted to ensure nothing important was lost.
Imported shows
When you import an episode from another podcast host, we do our best to keep the HTML as-is. However, it may be processed in a way that causes it to appear differently. Some features may be lost.
If you edit the show notes of an episode that was imported to Pinecast, we may enforce stricter rules on the resulting content.