• View
• Edit
• History
• Print
• Backlinks

ChordPro-Markup

Within the custom markup - ||: text :|| - added by ChordPro, ChordPro directives, lyrics, and chords, are specified.

Lyrics and chords

Text represents lyrics, within which chords, signified by square brackets, viz "[C#m7]", are embedded. Unlike a wiki white space and end of lines are recognised and honoured.

ChordPro directives

ChordPro directives consist of keywords encapsulated in braces (curly brackets), viz "{keyword}". Directives are not case sensitive, must be one per line, other content on a directive line is ignored.

Markup		Description	Note
Preamble markup
{title:..}	{t:..}	Song title	Formatted as <h2>
{subtitle:..}	{st:..}	Subtitle	Usually composer or artist, formatted as <h3>
{album:..}	{a:..}	Album	Usually composer or artist
{capo:..}		Capo	Capo position
#		Comment line	These lines will not be displayed, must be in column 1.
Formatting markup
{comment:..}	{c:..}	Comment	e.g. 'Chorus'
{comment_italic:..}	{ci:..}	italic comment
{comment_box:..}	{cb:..}	Comment Box
{start_of_chorus}	{soc}	Start of chorus	For compatibility also recognises {start_of_choir)
{end_of_chorus}	{eoc}	End of a chorus	For compatibility also recognises {end_of_choir)
{start_of_tab}	{sot}	Start of tab	For preformatted tab etc
{end_of_tab}	{eot}	End of a tab
Output markup		This recipe recogises these, but ignores them
{artist:..}		Ignored
{chordfont:..}		Ignored
{chordsize:..}		Ignored
{composer:..}		Ignored
{define:..}		Defines a special chord	<chord name> <position> <String6>..<String1> e.g.: G 1 3 2 0 0 0 3 graphical representation of chords
{duration:..}		Ignored
{grid}	{g}	Ignored
{key:..}		Ignored
{lyricist:..}		Ignored
{rowname}		Ignored
{textfont:..}		Ignored
{textsize:..}		Ignored
{new_page}	{np}	Uses style "clear: both; page-break-after: always;"	May work with some browsers
{new_physical_page}	{npp}	Uses style "clear: both; page-break-after: always;"	May work with some browsers
{new_song}	{ns}	Ignored
{no_grid}	{ng}	Ignored
{tempo:..}		Ignored
{tuning:..}		Ignored
{year:..}		Ignored
['|]		Vertical bar	Use [|]

References

• http://webchord.sourceforge.net/tech.html
• http://tenbyten.com/software/songsgen/help/HtmlHelp/files_reference.htm
• http://www.vromans.org/johan/projects/Chordii/chordpro/index.html
• http://linkesoft.com/songbook/manual.html#chordproformat

See also