Directives: start_of_abc

EXPERIMENTAL

This directive indicates that the lines that follow define a piece of music written in ABC music notation.

For example

{start_of_abc}
T:The Gentle Breeze
M:2/4
L:1/8
R:Air
K:Em
E>F G/2E/2-E| {A}B2{^c/2B/2}A>B| G/2E/2-E d2| B/2^c/2d B/2c/2d| e>f d>f|\
e3 B| g>B f>B| ef| eB F>B| E4:|
{end_of_abc}

The result could look like:

Important To render ABC, ChordPro makes use of external tools to convert the ABC source to an image, and then embeds the image (see image directive). Depending on the external tools support for embedded ABC may be limited, or absent.

This directive may include an optional label, to be printed in the left margin. For example:,

{start_of_abc: Intro}

The ChordPro reference implementation prints the label in the left margin, see labels.

General rules for embedding ABC source

  • All information fields are ignored except for K (key), L (unit), M (meter), P (part) and Q (tempo).

  • Default values will be supplied if possible for:

    • K: the value set by a {key} directive.
    • M: the value set by a {time} directive.
    • Q: the value set by a {tempo} directive.
  • ChordPro transposition using {transpose} and/or --transpose will transpose the embedded ABC. Adding %%transpose to the ABC source will affect the ABC notes only.

  • The ABC data is converted and included as a single image. No vertical splitting between staves.

Since the actual rendering is handled by external tools, ChordPro has no control over what and how the output will look like.

Directives: end_of_abc

This directive indicates the end of the abc section.