Enum Block 

pub enum Block {
    Heading {
        id: NodeId,
        level: HeadingLevel,
        inlines: Vec<Inline>,
        attributes: Attributes,
        position: Option<SourcePos>,
        span: Option<SourceSpan>,
    },
    Paragraph {
        id: NodeId,
        inlines: Vec<Inline>,
        attributes: Attributes,
        position: Option<SourcePos>,
        span: Option<SourceSpan>,
    },
    Blockquote {
        id: NodeId,
        blocks: Vec<Block>,
        attributes: Attributes,
        position: Option<SourcePos>,
        span: Option<SourceSpan>,
    },
    CodeBlock {
        id: NodeId,
        info: Option<String>,
        text: String,
        attributes: Attributes,
        position: Option<SourcePos>,
        span: Option<SourceSpan>,
    },
    ThematicBreak {
        id: NodeId,
        attributes: Attributes,
        position: Option<SourcePos>,
        span: Option<SourceSpan>,
    },
    PageBreak {
        id: NodeId,
        attributes: Attributes,
        position: Option<SourcePos>,
        span: Option<SourceSpan>,
    },
    ColumnBreak {
        id: NodeId,
        attributes: Attributes,
        position: Option<SourcePos>,
        span: Option<SourceSpan>,
    },
    Image {
        id: NodeId,
        url: String,
        alt: String,
        attributes: Attributes,
        position: Option<SourcePos>,
        span: Option<SourceSpan>,
    },
    List {
        id: NodeId,
        ordered: bool,
        start: u32,
        tight: bool,
        items: Vec<ListItem>,
        attributes: Attributes,
        position: Option<SourcePos>,
        span: Option<SourceSpan>,
    },
    Table {
        id: NodeId,
        head: Vec<Row>,
        body: Vec<Row>,
        attributes: Attributes,
        position: Option<SourcePos>,
        span: Option<SourceSpan>,
    },
}

A block-level element: the unit of fragmentation input.

Variants

Heading

# through ######; levels outside 1–6 are rejected at parse.

Fields

id: NodeId

Engine-assigned identity, for diagnostics; never serialized.

level: HeadingLevel

# count, 1-6.

inlines: Vec<Inline>

The heading’s text, in reading order.

attributes: Attributes

What a sheet names it by.

position: Option<SourcePos>

Where the frontend read this from.

span: Option<SourceSpan>

The bytes of that source it was read from.

Paragraph

A run of prose: the unit line layout breaks.

Fields

id: NodeId

Engine-assigned identity, for diagnostics; never serialized.

inlines: Vec<Inline>

The paragraph’s text, in reading order.

attributes: Attributes

What a sheet names it by.

position: Option<SourcePos>

Where the frontend read this from.

span: Option<SourceSpan>

The bytes of that source it was read from.

Blockquote

A quotation set off by >; contents are blocks, not inlines — blockquotes nest.

Fields

id: NodeId

Engine-assigned identity, for diagnostics; never serialized.

blocks: Vec<Block>

The quoted blocks, in reading order.

attributes: Attributes

What a sheet names it by.

position: Option<SourcePos>

Where the frontend read this from.

span: Option<SourceSpan>

The bytes of that source it was read from.

CodeBlock

A code block: preformatted text, set as it was written.

It holds text rather than inlines, because a code block has no markup inside it. The text keeps the newlines and the spaces the author wrote, and those are what its lines break at.

Fields

id: NodeId

Engine-assigned identity, for diagnostics; never serialized.

info: Option<String>

The word after the opening fence, where one was written. It is carried for a painter that reads it, and the engine makes nothing of it.

text: String

The block’s text, newlines and indentation intact.

attributes: Attributes

What a sheet names it by.

position: Option<SourcePos>

Where the frontend read this from.

span: Option<SourceSpan>

The bytes of that source it was read from.

ThematicBreak

---: a scene break, rendered as space or an ornament (❦).

Fields

id: NodeId

Engine-assigned identity, for diagnostics; never serialized.

attributes: Attributes

What a sheet names it by.

position: Option<SourcePos>

Where the frontend read this from.

span: Option<SourceSpan>

The bytes of that source it was read from.

PageBreak

\pagebreak: what follows it starts a new page. It holds no text and takes no height.

Fields

id: NodeId

Engine-assigned identity, for diagnostics; never serialized.

attributes: Attributes

What a sheet names it by.

position: Option<SourcePos>

Where the frontend read this from.

span: Option<SourceSpan>

The bytes of that source it was read from.

ColumnBreak

\columnbreak: what follows it starts the next column. It holds no text and takes no height.

Fields

id: NodeId

Engine-assigned identity, for diagnostics; never serialized.

attributes: Attributes

What a sheet names it by.

position: Option<SourcePos>

Where the frontend read this from.

span: Option<SourceSpan>

The bytes of that source it was read from.

Image

A block-level image.

Fields

id: NodeId

Engine-assigned identity, for diagnostics; never serialized.

url: String

Where the image lives; the host resolves it, not the engine.

alt: String

Alt text: not laid out, but part of the accessibility contract.

attributes: Attributes

What a sheet names it by.

position: Option<SourcePos>

Where the frontend read this from.

span: Option<SourceSpan>

The bytes of that source it was read from.

List

A list of items, numbered or not. An item holds blocks, as a blockquote does, so a list nests inside an item of another.

Fields

id: NodeId

Engine-assigned identity, for diagnostics; never serialized.

ordered: bool

Whether the items are numbered.

start: u32

The number of the first item of a numbered list.

tight: bool

Whether the source wrote the items without blank lines between them: a list of phrases rather than a list of paragraphs.

items: Vec<ListItem>

The items, in reading order.

attributes: Attributes

What a sheet names it by.

position: Option<SourcePos>

Where the frontend read this from.

span: Option<SourceSpan>

The bytes of that source it was read from.

Table

A grid of cells. A cell holds blocks, as a blockquote does.

Fields

id: NodeId

Engine-assigned identity, for diagnostics; never serialized.

head: Vec<Row>

The header rows, which name the columns, in reading order.

body: Vec<Row>

The body rows, in reading order.

attributes: Attributes

What a sheet names it by.

position: Option<SourcePos>

Where the frontend read this from.

span: Option<SourceSpan>

The bytes of that source it was read from.

Trait Implementations

impl Clone for Block

fn clone(&self) -> Block

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Block

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Block

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Block

fn eq(&self, other: &Block) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Block

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Block