Lyrics Editor — raspberry-text-monitor

Editor Ln 1, Col 1

Preview — as displayed on monitor

Font size 24px

Refrain Bridge

Dark bg

Ready 0 lines raspberry-text-monitor · Song Format v1

Song Lyrics Format

Specification for the .md lyric files used by raspberry-text-monitor

Overview

Files are standard Markdown with several custom extensions processed by Showdown.js. Each non-empty lyric line automatically gets a <br> appended, so single line-breaks in the source render as line-breaks on screen (no need for trailing spaces). Blank lines create paragraph spacing.

Section Tags

Syntax	Renders as	Default color
~refrain~…~/refrain~	Block with CSS class `.refrain`	yellow
~bridge~…~/bridge~	Block with CSS class `.bridge`	orange
~anything~…~/anything~	Block with CSS class `.anything`	(inherits text color — add custom CSS)

The tag name becomes the CSS class, so you can style any named section via the server's CSS.

Inline Color Spans

Syntax	Renders as	Notes
=gold=…=/gold=	`style="color: gold"`	Any valid CSS color name works
=red=…=/red=	`style="color: red"`	Can span multiple lines
=colorname=…=/colorname=	`style="color: colorname"`	Named colors only (no hex)

Multi-Column Layout

Use the ⬛⬛ 2-col layout toolbar button to insert a two-column layout. It adds a flex: true YAML front matter block (which switches the lyrics container to display: flex) together with ##left## and ##right## column dividers. These two features only make sense together.

Syntax	Renders as
##left##…##/left##	Div with class `.left` — first column
##right##…##/right##	Div with class `.right` — second column
##anything##…##/anything##	Div with class `.anything`

The YAML front matter (---\nflex: true\n---) must appear at the very top of the file.

Standard Markdown

All standard Markdown is supported: **bold**, *italic*, headings, etc. In practice, bold is the most commonly used formatting within lyrics.

Annotations / Stage Notes

Square brackets are used for stage notes and repetition markers. They render as plain text (no special styling), but by convention are used for notes like [REFRAIN], [2x], [8 Takte], [6x].

Example File

Raw source	What you get
--- flex: false --- Verse line one Verse line two ~refrain~ Chorus line A Chorus line B ~/refrain~ ~bridge~ Bridge section ~/bridge~ =gold=solo A=/gold= =red=solo B=/red= Outro line [4x]	Verse line one Verse line two (blank line) [YELLOW] Chorus line A [YELLOW] Chorus line B (blank line) [ORANGE] Bridge section (blank line) [gold] solo A [red] solo B (blank line) Outro line [4x]

Raw source

What you get

---
flex: false
---
Verse line one
Verse line two

~refrain~
Chorus line A
Chorus line B
~/refrain~

~bridge~
Bridge section
~/bridge~

=gold=solo A=/gold= =red=solo B=/red=

**Outro line** [4x]

Verse line one
Verse line two
(blank line)
[YELLOW] Chorus line A
[YELLOW] Chorus line B
(blank line)
[ORANGE] Bridge section
(blank line)
[gold] solo A  [red] solo B
(blank line)
Outro line [4x]

Copied to clipboard!

Open Song

Insert Snippet