USFM 3.0 additions or revisions are highlighted throughout this documentation using the badge
Letter opening: \po
Embedded list: \lim#
Hebrew note: \qd
Open discussion - Translator’s chunk marker
Aramaic wordlist entry: \wa …\wa*
Geographic proper name (Chinese texts): \png …\png*
Target references “added” text: \xta …\xta*
Published cross reference origin text: \xop …\xop*
List item total: \litl …\litl*
Semantic division: \sd#
Link text: \jmp …\jmp*
Common peripheral identifiers.
Support citation form for wordlist / glossary text (update \w …\w*).
Deprecate combined marker for proper name within translator’s addition: \addpn …\addpn*
Deprecate numbered running header: \h#
Syntax and Features
Syntax for assigning word-level descriptive attributes.
Syntax for assigning word-level linking attributes.
Support for nesting character markup.
Full support for the nested character markup syntax has been included in Paratext >=7.4, Publishing Assistant >=4.1, and the XML export format from Paratext known as “USX”.
Primarily a documentation update.
Paratext 7.3 and beyond provides support for study Bible content authoring, within a single project text, through an enhanced multi-pane editing window. Earlier USFM documentation releases discussed study Bible content markup using one or two additional related project texts. This multi-project authoring configuration is no longer recommended now that there is workable authoring environment supporting a single-project study Bible text. Information relating to study Bible content markup and authoring practice in this documentation supersedes any reference to separate notes or sidebar projects in the earlier release notes (below).
\fs(footnote summary text) - not required when working within a single project study Bible text.
Version numbers for the base USFM stylesheet and the study Bible notes and sidebars stylesheets have been synchronized to 2.3. This reflects the readiness of the ParaTExt 7.1 editor to support study Bible authoring.
Added study Bible cross reference marker \ex for adding additional cross-references to the notes project.
DEPRECATED - Study Bible footnote marker
\fsfor marking a footnote summary text.
Permit cross references to be added to the study Bible notes project.
Revised markup specification for study Bible sidebars (now use any title, paragraph, poetry, table, or special text marker elements).
Added \iqt …\iqt* to mark (scripture) quotations appearing in the introduction.
\imte# now includes an optional numeric variable (multiple levels).
No-break space should now be marked using ~ (tilde), not !$
Added \ili for marking introduction list items.
Reviewed and finalized Peripheral content markup:
The following sections outline changes in USFM from 1.53 to 2.0.
\pde, and substitute with embedded text markup (under additions, below)
\wr ...\wr*. This was really a duplicate of \w …w* used for marking words in the scripture text which are included in the wordlist.
\ps. This is used in conjunction with \nb to indicate that the paragraph spans the chapter boundary. It should be sufficient to just start the new chapter with \nb and use the appropriate paragraph marker for the previous chapter (\p, \m etc.)
Add character style \em …\em* for “emphasis”.
Add \intro section to Front Matter (in addition to Preface).
Add \maps (Maps Index) section to Back Matter.
Paratext will be adjusted to include predefined “standard” books for FRT, BAK, and OTH rather than using the book names XXA, XXB, and XXC for these materials.
Add the following markers for “embedded text” (see example references – not all versions mark these items the same).
Add character style \pro …\pro* for indicating pronunciation (in CJK texts).
Add character style \wj …\wj* for marking words of Jesus.