ADF node: paragraph

Node

Description

The paragraph node is a container for a block of formatted text delineated by a carriage return. It’s the equivalent of the HTML <p> tag.

Implementation Note: In the Java library, most nodes that are frequently used with simple paragraph and text nodes also provide methods that accept String values for convenience. Where these are available, they implicitly wrap the strings in text and paragraph nodes as required.

Example

Java

1
2
p("Hello world")

ADF

1
2
3
4
5
6
7
8
9
10
{
  "type": "paragraph",
  "content": [
    {
      "type": "text",
      "text": "Hello world"
    }
  ]
}

Result

Hello world

Compatibility

Products

Nodes/Usage

• BlockquoteContent – no marks1
• BlockTaskItemContent – no marks2
• DocContent
• LayoutColumnContent – no marks3
• ListItemContent – no marks4
• NestedExpandContent – no marks5
• NonNestableBlockContent – no marks6
• PanelContent – no marks7
• TableCellContent – no indentation8

Marks

• alignment
• indentation

Structure

• type - paragraph
• content - array(InlineContent…)
• marks? - array(PositionMark?)
• attrs?
  • localId? - string (should not be empty, and likely to be a UUID, but neither is enforced)

---

1. Although paragraph nodes are usually permitted to have a mark, such as alignment or indentation, these are not permitted in most of the cases where the paragraph is within another block element.↩︎
2. Although paragraph nodes are usually permitted to have a mark, such as alignment or indentation, these are not permitted in most of the cases where the paragraph is within another block element.↩︎
3. Although paragraph nodes are usually permitted to have a mark, such as alignment or indentation, these are not permitted in most of the cases where the paragraph is within another block element.↩︎
4. Although paragraph nodes are usually permitted to have a mark, such as alignment or indentation, these are not permitted in most of the cases where the paragraph is within another block element.↩︎
5. Although paragraph nodes are usually permitted to have a mark, such as alignment or indentation, these are not permitted in most of the cases where the paragraph is within another block element.↩︎
6. Although paragraph nodes are usually permitted to have a mark, such as alignment or indentation, these are not permitted in most of the cases where the paragraph is within another block element.↩︎
7. Although paragraph nodes are usually permitted to have a mark, such as alignment or indentation, these are not permitted in most of the cases where the paragraph is within another block element.↩︎
8. It is not clear why paragraph nodes inside a table cell can only use alignment, not indentation, especially since heading nodes do not have this same limitation. Nevertheless, that is what the schema says.↩︎