Support / Markdown Guide

Markdown Formatting

A quick-start cheat sheet for formatting text in the app's text card editor.


What is markdown?

Markdown is a simple way to format text using plain characters. When you type **bold** it appears as bold. The text card editor in the app supports markdown, so you can format your reading materials without needing HTML or any special tools.


Quick reference

What you type What you get Use for
# Heading Heading Section titles
## Subheading Subheading Subsections
**bold text** bold text Emphasis
*italic text* italic text Titles, terms
::blue[text] the words in blue Highlighting key terms
- Item one • Item one Bullet lists
1. First 1. First Numbered lists
[Link text](url) Link text Linking to resources
![Alt text](url) (image) Adding images
> Quote text Quote text Quotes, callouts
---
Section dividers

Rendered examples

Here is how these look side-by-side, showing what you type on the left and what appears in the app on the right.

You type # Session One Welcome to the first session of the programme. ## What to expect In this session you will: - Learn the basics of **mindful awareness** - Try a short *guided practice* - Reflect on your experience > "The present moment is the only moment available to us, and it is the door to all moments." - Thich Nhat Hanh
You see

Session One

Welcome to the first session of the programme.

What to expect

In this session you will:

  • Learn the basics of mindful awareness
  • Try a short guided practice
  • Reflect on your experience
"The present moment is the only moment available to us, and it is the door to all moments." - Thich Nhat Hanh

Coloured text

The text card editor adds one feature that is not part of standard markdown: you can colour a span of text. Wrap the words you want to colour in ::colour[text] and they appear in that colour. For example, ::blue[important] shows the word important in blue. It is a simple way to highlight a key term or gently flag a warning.

Six colours are available:

::red[…]
::green[…]
::orange[…]
::teal[…]
::blue[…]
::purple[…]
You type Today we will practise ::blue[mindful breathing]. ::red[**Before you start:**] find a quiet, comfortable space. Notice the difference between ::teal[tension] and ::green[ease].
You see

Today we will practise mindful breathing.

Before you start: find a quiet, comfortable space.

Notice the difference between tension and ease.

Good to know: Colour names are not case-sensitive, so ::Blue[…] works just as well as ::blue[…]. You can combine colour with emphasis by nesting, so ::red[**attention**] is both red and bold. A link works inside a coloured span too, for example ::teal[Read the [full guide](https://example.com) before class]; the link keeps its usual link colour, while the words around it take the colour you chose. And if you mistype a colour name, the text simply appears in the normal colour with no broken markers left behind.


Export from Google Docs

If you already have your content in a Google Doc, you can export it in markdown format. This is the fastest way to get formatted documents into the platform without manually typing markdown.

1 Open your document in Google Docs
2 Go to File > Download > Markdown (.md)
3 Open the downloaded file in a text editor (TextEdit, Notepad, or similar)
4 Copy the content and paste it into the text card editor in the app

Note: The Google Docs markdown export handles headings, bold, italic, lists, and links well. You may need to tidy up image references or complex formatting manually after pasting.


What the text card editor supports

The text card editor in the app supports the most common markdown features:

Headings (levels 1 through 6)
Bold and italic text
Links to external resources
Inline images
Bullet and numbered lists
Blockquotes
Code blocks
Horizontal rules
Coloured text (six colours)

Heads up: Some advanced markdown features such as tables, footnotes, and task lists may not render in the app. If you need complex layouts, consider breaking the content across multiple text cards.

Next
Frequently Asked Questions

Last updated: 11 June 2026