song2html

name	song2html
description	Read, write, parse, validate, transpose, and render song chord charts in the song2html format — a plain-text notation for chord charts with lyrics, Nashville numbers, and arrangements.

song2html — Chord Chart Plugin

Create, edit, and convert song chord charts using the song2html plain-text format.

Format Quick Reference

Song Title [Key]
  author: Songwriter Name
  tempo: 120
  time: 4/4

  verse: G C D G
  chorus: C D Em G

Sections:
  Verse 1:
    ^Lyrics with ^caret markers for ^chord ^placement

  Chorus:
    ^Chorus ^lyrics ^with ^chords

Arrangements:
  Full:
    Verse 1
    Chorus

Key Syntax Rules

• Title line: first line, optional key in brackets [G], [F#m], [Bb]
• Metadata: 2-space indented — author:, key:, tempo:, time:
• Chord definitions: 2-space indented — section-name: chord1 chord2 ...
• Sections header: Sections: followed by named sections with 4-space indented lyrics
• Caret ^: marks where the next chord is placed above lyrics
• Nashville numbers: 1–7 auto-transpose based on key
• Slash chords: C/G (bass), F\A (treble)
• Repetition: (G C) x2 expands to G C G C
• Transpose directive: <transpose +2> shifts Nashville numbers