A set of converters to convert to and from ChordMark format.
npm install chord-mark-converters
This is the most widely used chord charts format on the web: chords are displayed above the lyrics where they are supposed to be played. Websites like Ultimate Guitar use this format.
Use as follow:
import { convert2ChordMark } from 'chord-mark-converters';
const input = `[Verse]
C Am
I heard there was a secret chord`;
const chordMark = convert2ChordMark(input, { inputFormat: 'chordsOverLyrics' });
import { convert2ChordMark } from 'chord-mark-converters';
const input = `I [C]heard there was a [Am]secret chord`;
const chordMark = convert2ChordMark(input, { inputFormat: 'chordPro' });
In both examples above, the following ChordMark string will be generated:
#v
C Am
I _heard there was a _secret chord
If you omit the inputFormat
parameter, convert2ChordMark
will try to automagically select between ChordOverLyrics
and ChordPro
.
const chordMark = convert2ChordMark(input);
If you use a digital songbook application such as MobileSheetPro
or onSong
, chances are they will allow importing chord charts in the ChordPro format.
To convert a song in the ChordMark format to ChordPro, proceed as follow:
import { chordMarkToChordPro } from 'chord-mark-converters';
const input = `#v
C Am
I _heard there was a _secret chord`;
const parsed = parseSong(input);
const chordPro = renderSong(parsed, {
customRenderer: chordMarkToChordPro({ showBarSeparators: true }),
});
This will produce the following string:
{start_of_verse: Verse}
I [|] [C]heard there was a [|] [Am]secret chord [|]
{end_of_verse}
Use this converter if you want to publish chord charts created with ChordMark to the Ultimate Guitar website.
Due to the website publication rules, however, you will lose most of the ChordMark goodies such as the bar separators and the beat count indicators
(at least for the bars with lyrics).
You also need to use the appropriate chord symbol renderer (e.g. chord-symbol-ultimateguitar
) and configure the rendering as follow:
import { parseSong, renderSong } from 'chord-mark';
import { chordMarkToUltimateGuitar } from 'chord-mark-converters';
import { chordRendererFactory } from 'chord-symbol';
import chordSymbolUltimateGuitar from 'chord-symbol-ultimateguitar';
const input = `#v
C Am
I _heard there was a _secret chord`;
const parsed = parseSong(input);
const ultimateGuitar = renderSong(parsed, {
printBarSeparators: 'grids',
printChordsDuration: 'never',
printInlineTimeSignatures: false,
printSubBeatDelimiters: false,
customRenderer: chordMark2UltimateGuitar(),
chordSymbolRenderer: chordRendererFactory({
customFilters: [chordSymbolUltimateGuitar()],
useShortNamings: true,
}),
});
This will produce the following string:
[Verse]
[ch]C[/ch] [ch]Am[/ch]
I heard there was a secret chord