Template:Paragraph break/doc

This is a documentation subpage for Template:Paragraph break.
It may contain usage information, categories and other content that is not part of the original template page.

This template is used in system messages, and on approximately 1,230,000 pages, or roughly 2% of all pages.
Changes to it can cause immediate changes to the Wikipedia user interface.
To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Please discuss changes on the talk page before implementing them.

Shortcuts

{{pb}}
{{parabr}}
{{paragraph}}

Usage

This template produces a "visual paragraph break" by inserting the following empty tag pair:

<div class="paragraphbreak"></div>

Example:

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.{{paragraph break}}Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

produces:

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

Purpose

In some instances, it is not possible to introduce paragraph breaks using newlines alone. For example, within a list item and within references. However, using <p> tags can cause problems for navigation with screen readers, which expect these tags to delimit paragraphs of prose (see e.g. MOS:INDENTGAP). This template is used mostly in footnotes, where a visual break is desired, without adding an additional paragraph navigation point.

Example 1

The following reference uses line breaks for multiple lines.^[1] The following reference uses the paragraph break template for paragraph breaks.^[2] The following reference uses <br /> tags for paragraph breaks.^[3]

Notes

^ Paragraph 1a Paragraph 1b
^ Paragraph 2a
Paragraph 2b
^ Line 3a
Line 3b

which was generated using:

1.<ref>Paragraph 1a
Paragraph 1b</ref>
2. <ref>Paragraph 2a{{paragraph break}}Paragraph 2b</ref>
3. <ref>Line 3a<br />Line 3b</ref>

Example 2

Consider the following list

Paragraph 1a
Paragraph 1b
Paragraph 2

which was generated using

# Paragraph 1a {{paragraph break}} Paragraph 1b
# Paragraph 2

Produces a "visual paragraph break".

Template parameters
Parameter		Description	Type	Status
No parameters specified

[1] Paragraph 1a Paragraph 1b

[2] Paragraph 2a
Paragraph 2b

[3] Line 3a
Line 3b

[1]

[2]

[3]