Struct Block 

pub struct Block {
    pub id: BlockId,
    pub document_id: DocumentId,
    pub block_type: BlockType,
    pub content: String,
    pub span: Option<Span>,
    pub pre: u32,
    pub post: u32,
    pub properties: Properties,
}

A single logical block extracted from a Markdown document.

Interval Index

The pre and post fields implement the Nested Set / Pre-Post Order interval index for the section hierarchy (defined by headings).

A block A is a descendant of block B iff:

B.pre < A.pre  &&  A.post < B.post

This reduces ancestor/descendant checks to O(1) integer comparisons, eliminating recursive tree traversal entirely.

Fields

id: BlockId

document_id: DocumentId

block_type: BlockType

content: String

Plain-text content rendered from the block (without markup).

span: Option<Span>

Source location (line/column, 1-based). None for synthetic blocks.

pre: u32

Pre-order DFS number – left boundary of the section interval.

post: u32

Post-order DFS number – right boundary of the section interval.

properties: Properties

Row-polymorphic extra attributes; keyed by property name.

Implementations

impl Block

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

Returns true if other is a descendant of self in the section hierarchy (i.e. other is “under” self).

Uses the interval index for O(1) comparison.

pub fn is_under(&self, ancestor: &Block) -> bool

Returns true if self is a descendant of ancestor.

pub fn is_under_interval(&self, anc_pre: u32, anc_post: u32) -> bool

Returns true if self falls within the given ancestor interval (anc_pre, anc_post).

pub fn heading_depth(&self) -> Option<u8>

Heading depth (1–6), or None for non-heading blocks.

pub fn code_lang(&self) -> Option<&str>

Code language tag (e.g. "rust"), or None for non-code blocks.

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 PartialEq for Block

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Block