# page.cavu.blocks.verse

> Published by [cavu.page](https://lexicon.garden/identity/did:plc:citulkqjdzbnf7wd5xb6lled)

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:citulkqjdzbnf7wd5xb6lled/page.cavu.blocks.verse)
- [Documentation](https://lexicon.garden/lexicon/did:plc:citulkqjdzbnf7wd5xb6lled/page.cavu.blocks.verse/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:citulkqjdzbnf7wd5xb6lled/page.cavu.blocks.verse/examples)

## Definitions

### `page.cavu.blocks.verse`

**Type**: `object`

A verse (poetry, song, inscription) block. Unlike prose blocks, whitespace is meaningful: a single newline is a hard line break, a blank line separates stanzas. Renderers should preserve line breaks, keep stanzas together, and style distinctly from prose (traditionally inset, often italic). Mirrors the shape of pub.leaflet.blocks.text so the same rich-text tooling applies. Designed to sit inside pub.leaflet.pages.* open block unions; renderers that don't recognize it skip it, so the document's textContent should still carry the verse plaintext.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `facets` | `array` | No | Byte-range annotations over plaintext (emphasis, links), same facet system as Leaflet blocks. |
| `plaintext` | `string` | Yes | The verse text with significant newlines: \n breaks a line, \n\n breaks a stanza. |

## Raw Schema

```json
{
  "id": "page.cavu.blocks.verse",
  "defs": {
    "main": {
      "type": "object",
      "required": [
        "plaintext"
      ],
      "properties": {
        "facets": {
          "type": "array",
          "items": {
            "ref": "pub.leaflet.richtext.facet",
            "type": "ref"
          },
          "description": "Byte-range annotations over plaintext (emphasis, links), same facet system as Leaflet blocks."
        },
        "plaintext": {
          "type": "string",
          "maxLength": 100000,
          "description": "The verse text with significant newlines: \\n breaks a line, \\n\\n breaks a stanza."
        }
      },
      "description": "A verse (poetry, song, inscription) block. Unlike prose blocks, whitespace is meaningful: a single newline is a hard line break, a blank line separates stanzas. Renderers should preserve line breaks, keep stanzas together, and style distinctly from prose (traditionally inset, often italic). Mirrors the shape of pub.leaflet.blocks.text so the same rich-text tooling applies. Designed to sit inside pub.leaflet.pages.* open block unions; renderers that don't recognize it skip it, so the document's textContent should still carry the verse plaintext."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```