Paragraphs

\p

Syntax

\p(_text...)

Type

paragraph

Added

1.0

Use

Normal paragraph.
Followed immediately by a space and paragraph text, or by a new line and a verse marker.

Text and Formatting Sample - Mark 1.1-4 (GNT)

\c 1
\s1 The Preaching of John the Baptist
\r (Matthew 3.1-12; Luke 3.1-18; John 1.19-28)
\p
\v 1 This is the Good News about Jesus Christ, the Son of God.
\v 2 It began as the prophet Isaiah had written:
\q1 “God said, ‘I will send my messenger ahead of you
\q2 to open the way for you.’
\q1
\v 3 Someone is shouting in the desert,
\q2 ‘Get the road ready for the Lord;
\q2 make a straight path for him to travel!’”
\p
\v 4 So John appeared in the desert, baptizing and preaching. “Turn away from your sins
and be baptized,” he told the people, “and God will forgive your sins.”
../_images/usfm-paragraph_p.jpg

\m

Syntax

\m(_text...)

Type

paragraph

Added

1.0

Use

Continuation (margin) paragraph.
No first line indent.
Followed immediately by a space and paragraph text, or by a new line and a verse marker.
Usually used to resume prose at the margin (without indent) after poetry or OT quotation (i.e. continuation of the previous paragraph).

Text and Formatting Sample - Mark 12.37 (GNT)

\p
\v 35 As Jesus was teaching in the Temple, he asked the question, “How can the teachers
of the Law say that the Messiah will be the descendant of David?
\v 36 The Holy Spirit inspired David to say:
\q1 ‘The Lord said to my Lord:
\q2 Sit here at my right side
\q2 until I put your enemies under your feet.’
\b
\m
\v 37 David himself called him ‘Lord’; so how can the Messiah be David's descendant?”
../_images/usfm-paragraph_m.jpg

\po

usfm3.0

Syntax

\po_text...

Type

paragraph

Added

3.0

Use

Opening of an epistle/letter.

Text and Formatting Sample - Romans 1.1,7 (GNT)

\c 1
\po
\v 1 From Paul, a servant of Christ Jesus and an apostle chosen and called by God to
preach his Good News.
\p
\v 2 The Good News was promised long ago by God through his prophets, as written in the
Holy Scriptures.
\v 3 It is about his Son, our Lord Jesus Christ: as to his humanity, he was born a
descendant of David;
\v 4 as to his divine holiness, he was shown with great power to be the Son of God by being
raised from death.
\v 5 Through him God gave me the privilege of being an apostle for the sake of Christ,
in order to lead people of all nations to believe and obey.
\v 6 This also includes you who are in Rome, whom God has called to belong to Jesus Christ.
\po
\v 7 And so I write to all of you in Rome whom God loves and has called to be his own
people:
\po May God our Father and the Lord Jesus Christ give you grace and peace.
../_images/usfm-paragraph_po.jpg

\pr

Syntax

\pr(_text...)

Type

paragraph

Added

1.0

Deprecated

2.0

Restored

3.0 usfm3.0

Use

Right-aligned paragraph.
ico_Cg Recommended use: Text refrain.

Text and Formatting Sample - Deuteronomy 27.15,16,17 (GNT - markup adapted)

\p
\v 15 “ ‘God's curse on anyone who makes an idol of stone, wood, or metal and secretly
worships it; the \nd Lord\nd* hates idolatry.’
\pr “And all the people will answer, ‘Amen!’
\p
\v 16 “ ‘God's curse on anyone who dishonors his father or mother.’
\pr “And all the people will answer, ‘Amen!’
\p
\v 17 “ ‘God's curse on anyone who moves a neighbor's property line.’
\pr “And all the people will answer, ‘Amen!’
../_images/usfm-paragraph_pr.jpg

\cls

Syntax

\cls_text...

Type

paragraph

Added

1.0

Use

Closure of an epistle/letter.
Similar to “With love,” or “Sincerely yours,”.

Text and Formatting Sample - Colossians 4.18 (GNT - markup adapted)

\p
\v 18 With my own hand I write this: \sig Greetings from Paul\sig*. Do not forget my chains!
\cls May God's grace be with you.
../_images/usfm-paragraph_cls.jpg

\pmo

Syntax

\pmo(_text...)

Type

paragraph

Added

2.0

Use

Embedded text opening.

Text and Formatting Sample - Acts 15.24 (CEV)

\p
\v 22 The apostles, the leaders, and all the church members decided to send some men to
Antioch along with Paul and Barnabas. They chose Silas and Judas Barsabbas, who were two
leaders of the Lord's followers.
\v 23 They wrote a letter that said:
\pmo We apostles and leaders send friendly greetings to all of you Gentiles who are
followers of the Lord in Antioch, Syria, and Cilicia.
\pm
\v 24 We have heard that some people from here have terribly upset you by what they said.
But we did not send them!
../_images/usfm-paragraph_pmo.jpg

\pm

Syntax

\pm(_text...)

Type

paragraph

Added

2.0

Use

Embedded text paragraph.

Text and Formatting Sample - Act 15.24-27,28-29 (CEV)

\pmo We apostles and leaders send friendly greetings to all of you Gentiles who are
followers of the Lord in Antioch, Syria, and Cilicia.
\pm
\v 24 We have heard that some people from here have terribly upset you by what they said.
But we did not send them!
\v 25 So we met together and decided to choose some men and to send them to you along with
our good friends Barnabas and Paul.
\v 26 These men have risked their lives for our Lord Jesus Christ.
\v 27 We are also sending Judas and Silas, who will tell you in person the same things that
we are writing.
\pm
\v 28 The Holy Spirit has shown us that we should not place any extra burden on you...
../_images/usfm-paragraph_pm.jpg

\pmc

Syntax

\pmc(_text...)

Type

paragraph

Added

2.0

Use

Embedded text closing.

Text and Formatting Sample - Act 15.28-29 (CEV)

\pm
\v 28 The Holy Spirit has shown us that we should not place any extra burden on you.
\v 29 But you should not eat anything offered to idols. You should not eat any meat that
still has the blood in it or any meat of any animal that has been strangled. You must also
not commit any terrible sexual sins. If you follow these instructions, you will do well.
\pmc We send our best wishes.
../_images/usfm-paragraph_pmc.jpg

\pmr

Syntax

\pmr_text...

Type

paragraph

Added

2.0

Use

Embedded text refrain.


\pi#

Syntax

\pi#(_Sample text...)

Type

paragraph

Added

1.0

Use

Indented paragraph.
Used in some texts for discourse sections.
The variable # represents the level of indent.
ico_See See also \pm
\pi = \pi1 (see syntax notes on numbered markers)

Text and Formatting Sample - Matthew 13.37-39 (CEV)

\s1 Jesus Explains the Story about the Weeds
\p
\v 36 After Jesus left the crowd and went inside, his disciples came to him and said,
“Explain to us the story about the weeds in the wheat field.”
\p
\v 37 Jesus answered:
\pi The one who scattered the good seed is the Son of Man.
\v 38 The field is the world, and the good seeds are the people who belong to the kingdom.
The weed seeds are those who belong to the evil one,
\v 39 and the one who scattered them is the devil. The harvest is the end of time, and
angels are the ones who bring in the harvest.
../_images/usfm-paragraph_pi.jpg

\mi

Syntax

\mi(_text...)

Type

paragraph

Added

1.0

Use

Indented flush left paragraph.
No first line indent.
ico_See See also \pmo, \pmc

Text and Formatting Sample - Matthew 11.18-19 (CEV)

\pi
\v 16 You people are like children sitting in the market and shouting to each other,
\b
\q1
\v 17 “We played the flute,
\q2 but you would not dance!
\q1 We sang a funeral song,
\q2 but you would not mourn!”
\b
\mi
\v 18 John the Baptist did not go around eating and drinking, and you said, “That man has
a demon in him!”
\v 19 But the Son of Man goes around eating and drinking, and you say, “That man eats and
drinks too much! He is even a friend of tax collectors ...
../_images/usfm-paragraph_mi.jpg

\nb

Syntax

\nb

Type

paragraph

Added

1.0

Use

Basic.
Indicates “no-break” with previous paragraph (regardless of previous paragraph type).
Commonly used in cases where the previous paragraph spans the chapter boundary.

Text and Formatting Sample - John 7.53–8.2 (CEV)

\p
\v 52 Then they said, “Nicodemus, you must be from Galilee! Read the Scriptures, and you
will find that no prophet is to come from Galilee.”
\s1 A Woman Caught in Sin
\p
\v 53 Everyone else went home,
\c 8
\nb
\v 1 but Jesus walked out to the Mount of Olives.
\v 2 Then early the next morning he went to the temple. The people came to him, and he
sat down and started teaching them.
../_images/usfm-paragraph_nb.jpg

Note

No-break markup within poetry: Some translations have a publishing tradition of inserting a small amount of additional white-space at chapter boundaries. It is important in these texts to use the nb marker within any specific poetic contexts where no visible break in the flow of the the text is intended at a particular chapter boundary.


\pc

Syntax

\pc(_text...)

Type

paragraph

Added

1.0

Use

Centered paragraph.

ico_Cg Recommended use: Inscriptions.

Text and Formatting Sample - Revelation 17.5 (CEV)

\v 4 The woman was dressed in purple and scarlet robes, and she wore jewelry made of
gold, precious stones, and pearls. In her hand she held a gold cup filled with the filthy
and nasty things she had done.
\v 5 On her forehead a mysterious name was written:
\pc I AM THE GREAT CITY OF BABYLON, THE MOTHER OF EVERY IMMORAL AND FILTHY THING ON EARTH.
\m
\v 6 I could tell that the woman was drunk on the blood of God's people who had given
their lives for Jesus. This surprising sight amazed me, ...
../_images/usfm-paragraph_pc.jpg

\ph#

Syntax

\ph#(_text...)

Type

paragraph

Added

1.0

Use

Indented paragraph with hanging indent.
The variable # represents the level of overall paragraph indent.
\ph = \ph1 (see syntax notes on numbered markers)
Deprecated (i.e. use is strongly discouraged).

ico_Cg Recommended alternate: \li#


\b

Syntax

\b

Type

paragraph

Added

1.0

Use

Blank line.
May be used to explicitly indicate additional white space between paragraphs.
ico_See See also: Poetry elements \b (used for stanza breaks in poetry, or between poetry and prose).

Warning

No text should follow this marker, and it should not be used before or after titles to indicate white-space.