Up: Text markup



4.5.1 Overview of text markup commands

\bigger arg (markup)
Increase the font size relative to current setting
\bold arg (markup)
Switch to bold font-series
\box arg (markup)
Draw a box round arg
\bracket arg (markup)
Draw vertical brackets around arg.
\bracketed-y-column indices (list) args (list of markups)
Make a column of the markups in args, putting brackets around the elements marked in indices, which is a list of numbers.
\caps arg (markup)
Set font shape to caps.
\center-align args (list of markups)
Put args in a centered column.
\char num (integer)
This produces a single character, e.g. \char #65 produces the letter 'A'.
\column args (list of markups)
Stack the markups in args vertically.
\combine m1 (markup) m2 (markup)
Print two markups on top of each other.
\dir-column args (list of markups)
Make a column of args, going up or down, depending on the setting of the #'direction layout property.
\doubleflat
Draw a double flat symbol.
\doublesharp
Draw a double sharp symbol.
\dynamic arg (markup)
Use the dynamic font. This font only contains s, f, m, z, p, and r. When producing phrases, like “più f”, the normal words (like “più”) should be done in a different font. The recommend font for this is bold and italic
\fill-line markups (list of markups)
Put markups in a horizontal line of width line-width. The markups are spaced/flushed to fill the entire line.
\finger arg (markup)
Set the argument as small numbers.
\flat
Draw a flat symbol.
\fontsize mag (number) arg (markup)
This sets the relative font size, e.g.
          A \fontsize #2 { B C } D
     

This will enlarge the B and the C by two steps.

\fraction arg1 (markup) arg2 (markup)
Make a fraction of two markups.
\general-align axis (integer) dir (number) arg (markup)
Align arg in axis direction to the dir side.
\halign dir (number) arg (markup)
Set horizontal alignment. If dir is -1, then it is left-aligned, while+1 is right. Values in between interpolate alignment accordingly.
\hbracket arg (markup)
Draw horizontal brackets around arg.
\hspace amount (number)
This produces a invisible object taking horizontal space.
          \markup { A \hspace #2.0 B }
     

will put extra space between A and B, on top of the space that is normally inserted before elements on a line.

\huge arg (markup)
Set font size to +2.
\italic arg (markup)
Use italic font-shape for arg.
\large arg (markup)
Set font size to +1.
\latin-i arg (markup)
TEST latin1 encoding.
\left-align arg (markup)
Align arg on its left edge.
\line args (list of markups)
Put args in a horizontal line. The property word-space determines the space between each markup in args.
\lookup glyph-name (string)
Lookup a glyph by name.
\magnify sz (number) arg (markup)
This sets the font magnification for the its argument. In the following example, the middle A will be 10% larger:
          A \magnify #1.1 { A } A
     

Note: magnification only works if a font-name is explicitly selected. Use \fontsize otherwise.

\markletter num (integer)
Make a markup letter for num. The letters start with A to Z (skipping I), and continues with double letters.
\musicglyph glyph-name (string)
This is converted to a musical symbol, e.g. \musicglyph #"accidentals-0" will select the natural sign from the music font. See The Feta font for a complete listing of the possible glyphs.
\natural
Draw a natural symbol.
\normal-size-sub arg (markup)
Set arg in subscript, in a normal font size.
\normal-size-super arg (markup)
A superscript which does not use a smaller font.
\normalsize arg (markup)
Set font size to default.
\note-by-number log (number) dot-count (number) dir (number)
Construct a note symbol, with stem. By using fractional values for dir, you can obtain longer or shorter stems.
\note duration (string) dir (number)
This produces a note with a stem pointing in dir direction, with the duration for the note head type and augmentation dots. For example, \note #"4." #-0.75 creates a dotted quarter note, with a shortened down stem.
\number arg (markup)
Set font family to number, which yields the font used for time signatures and fingerings. This font only contains numbers and some punctuation. It doesn't have any letters.
\override new-prop (pair) arg (markup)
Add the first argument in to the property list. Properties may be any sort of property supported by font-interface and text-interface, for example
     
     \override #'(font-family . married) "bla"

\raise amount (number) arg (markup)
This raises arg, by the distance amount. A negative amount indicates lowering:
      c1^\markup { C \small \raise #1.0 \bold { "9/7+" }}

[image of music]

The argument to \raise is the vertical displacement amount, measured in (global) staff spaces. \raise and \super raise objects in relation to their surrounding markups.

If the text object itself is positioned above or below the staff, then \raise cannot be used to move it, since the mechanism that positions it next to the staff cancels any shift made with \raise. For vertical positioning, use the padding and/or extra-offset properties.

\right-align arg (markup)

\roman arg (markup)
Set font family to roman.
\sans arg (markup)
Switch to the sans-serif family
\semiflat
Draw a semiflat.
\semisharp
Draw a semi sharp symbol.
\sesquiflat
Draw a 3/2 flat symbol.
\sesquisharp
Draw a 3/2 sharp symbol.
\sharp
Draw a sharp symbol.
\simple str (string)
A simple text-string; \markup { foo } is equivalent with \markup { \simple #"foo" }.
\small arg (markup)
Set font size to -1.
\smaller arg (markup)
Decrease the font size relative to current setting
\strut
Create a box of the same height as the space in the current font.

FIXME: is this working?

\sub arg (markup)
Set arg in subscript.
\super arg (markup)

Raising and lowering texts can be done with \super and \sub:

      c1^\markup { E "=" mc \super "2" }

[image of music]


\teeny arg (markup)
Set font size to -3.
\tiny arg (markup)
Set font size to -2.
\translate offset (pair of numbers) arg (markup)
This translates an object. Its first argument is a cons of numbers
          A \translate #(cons 2 -3) { B C } D
     

This moves `B C' 2 spaces to the right, and 3 down, relative to its surroundings. This command cannot be used to move isolated scripts vertically, for the same reason that \raise cannot be used for that.

.

\typewriter arg (markup)
Use font-family typewriter for arg.
\upright arg (markup)
Set font shape to upright.
\vcenter arg (markup)
Align arg to its center.
\word str (string)
A single word.

Read comments on this page, or add one.

This page is for LilyPond-2.2.6 (stable-branch).

Report errors to <bug-lilypond@gnu.org>.