Chapters and Verses

\c

Syntax:\c_#
Type:paragraph
Added:1.0
Use:Chapter number.
The marker is followed by the chapter number #.
No further text should follow this marker.

Text and Formatting Sample - Matthew 1 (GNT)

\io1 The last week in and near Jerusalem (21.1–27.66)
\io1 The resurrection and appearances of the Lord (28.1-20)
\c 1
\s1 The Ancestors of Jesus Christ
\r (Luke 3.23-38)
\p
\v 1 This is the list of the ancestors of Jesus Christ, a descendant of David, who was a
descendant of Abraham.
../_images/usfm-paragraph_c.jpg

\ca ...\ca*

Syntax:\ca_#\ca*
Type:character
Added:1.0
Use:Alternate chapter number.
Used for marking the chapter number used in an alternate versification scheme. Required when different versification traditions need to be supported in the same translation text.
The content within the marker pair should only contain the alternate chapter number, and not include any formatting/

Text and Formatting Sample - Psalm 54 (GNT - markup adapted)

\c 54
\ca 53\ca*
\s1 A Prayer for Protection from Enemies
\d \va 1\va* A poem by David, \va 2\va* after the men from Ziph went to Saul and told him
that David was hiding in their territory.
\q1
\v 1 \va 3\va* Save me by your power, O God;
\q2 set me free by your might!
\q1
\v 2 \va 4\va* Hear my prayer, O God;
\q2 listen to my words!
../_images/usfm-character_ca.jpg

\cl

Syntax:\cl_text...
Type:paragraph
Added:1.0
Use:The chapter “label” to be used when the chosen publishing presentation will render chapter divisions as headings (not drop cap numerals).

Note

Usage note: If \cl is entered once before chapter 1 (\c 1) it represents the text for “chapter” to be used throughout the current book. If \cl is used after each individual chapter marker, it represents the particular text to be used for the display of the current chapter heading (usually done if numbers are being presented as words, not numerals).

Text and Formatting Samples - Psalm 1 (GNT - markup adapted - general chapter label)

\cl Psalm
\c 1
\q1
\v 1 Happy are those
\q2 who reject the advice of evil people,
../_images/usfm-paragraph_cl.jpg

Psalm 1 (GNT - markup adapted - specific chapter label)

\c 1
\cl Psalm One
\q1
\v 1 Happy are those
\q2 who reject the advice of evil people,
../_images/usfm-paragraph_cl-alt.jpg

\cp

Syntax:\cp_text...
Type:paragraph
Added:1.0
Use:Published chapter character.
This is the chapter character (number, letter) which should be displayed in the published text (where the published marker is different than the \c # used within the translation editing environment).

Text and Formatting Sample - Esther-Greek 1 (“A”) (GNT)

\c 1
\cp A
\s1 Mordecai's Strange Dream
\p
\v 1-3 \va 2-4\va* Mordecai, a Jew who belonged to the tribe of Benjamin, was taken into
exile, along with King Jehoiachin of Judah, when King Nebuchadnezzar of Babylonia captured
Jerusalem. ...
../_images/usfm-paragraph_cp.jpg

\cd

Syntax:\cd_text...
Type:paragraph
Added:1.0
Use:Chapter description.
A brief description of chapter content (similar to d - descriptive heading, or iex - ).

Text and Formatting Sample - Genesis 1 (Russian Synodal, Protestant Version)

\c 2
\cd 1 Бог благословляет седьмой день; 8 человек в раю Едемском; четыре реки; дерево
познания добра и зла. 18 Человек дает названия животным. 21 Создание женщины.
\p
\v 1 Так совершены небо и земля и все воинство их.
\p
\v 2 И совершил Бог к седьмому дню дела Свои, которые Он делал, и почил в день седьмой
от всех дел Своих, которые делал.
../_images/usfm-paragraph_cd.jpg

\v

Syntax:\v_#
Type:character
Added:1.0
Use:Verse number.
Marker is followed by the verse number #, and the text of the verse.

Text and Formatting Sample - Matthew 1.18,19 (GNT)

\s1 The Birth of Jesus Christ
\r (Luke 2.1-7)
\p
\v 18 This was how the birth of Jesus Christ took place. His mother Mary was engaged
to Joseph, but before they were married, she found out that she was going to have a
baby by the Holy Spirit.
\v 19 Joseph was a man who always did what was right, but he did not want to disgrace
Mary publicly; so he made plans to break the engagement privately.
../_images/usfm-character_v.jpg

\va ...\va*

Syntax:\va_#\va*
Type:character
Added:1.0
Use:Alternate verse number.
Used for marking verse numbers used in an alternate versification scheme. Required when different versification traditions need to be supported in the same translation text.
The content within the marker pair should only contain the alternate verse number, and not include any formatting/presentation characters (e.g. brackets or parentheses)

Text and Formatting Sample - Psalm 54 (GNT - markup adapted)

\c 54
\ca 53\ca*
\s1 A Prayer for Protection from Enemies
\d \va 1\va* A poem by David, \va 2\va* after the men from Ziph went to Saul and told
him that David was hiding in their territory.
\q1
\v 1 \va 3\va* Save me by your power, O God;
\q2 set me free by your might!
\q1
\v 2 \va 4\va* Hear my prayer, O God;
\q2 listen to my words!
../_images/usfm-character_va.jpg

\vp ...\vp*

Syntax:\vp text...\vp*
Type:character
Added:1.0
Use:Published verse character.
This is the verse character (number, letter) which should be displayed in the published text (where the published character(s) are different than the \v # digit used within the translation editing environment).

Text and Formatting Sample - Esther-Greek 3.14,15 (“Addition B”) (CEV)

\cp 13
\ms1 Addition B
\s A Copy of the Letter
\p
\v 14 \vp 1b\vp* This is a copy of the letter:
\pmo From Artaxerxes, the Great King, to the governors and officials of my one hundred
twenty-seven provinces from India to Ethiopia.
\pm
\v 15 \vp 2b\vp* I rule many nations, and I am the most powerful king in the world.
But I have never used my power in a proud or arrogant way. Instead, I have always
been reasonable and kind to the people in my kingdom. I know they want peace, and so
I have decided to make every part of my kingdom peaceful and safe for travel.
../_images/usfm-character_vp.jpg