Struct ExtensionMark 

pub struct ExtensionMark {
    pub namespace: String,
    pub mark_type: String,
    pub attributes: Value,
}

An extension mark for unsupported or unknown mark types.

When parsing a document with extension marks (e.g., “semantic:citation”), this struct preserves the raw data so it can be:

• Passed through unchanged when saving
• Processed by extension-aware applications

Fields

namespace: String

The extension namespace (e.g., “semantic”, “legal”, “presentation”).

mark_type: String

The mark type within the namespace (e.g., “citation”, “entity”, “index”).

attributes: Value

Extension-specific attributes.

Implementations

impl ExtensionMark

pub fn new(namespace: impl Into<String>, mark_type: impl Into<String>) -> Self

Create a new extension mark.

pub fn parse_type(type_str: &str) -> Option<(&str, &str)>

Parse an extension type string like “semantic:citation” into (namespace, mark_type).

Returns None if the type doesn’t contain a colon.

pub fn full_type(&self) -> String

Get the full type string (e.g., “semantic:citation”).

pub fn is_namespace(&self, namespace: &str) -> bool

Check if this extension is from a specific namespace.

pub fn is_type(&self, namespace: &str, mark_type: &str) -> bool

Check if this is a specific extension type.

pub fn with_attributes(self, attributes: Value) -> Self

Set the attributes.

pub fn get_attribute(&self, key: &str) -> Option<&Value>

Get an attribute value by key.

pub fn get_string_attribute(&self, key: &str) -> Option<&str>

Get a string attribute.

pub fn get_string_array_attribute(&self, key: &str) -> Option<Vec<&str>>

Get an array-of-strings attribute.

pub fn get_citation_refs(&self) -> Option<Vec<&str>>

Get citation refs, supporting both "refs" (array) and legacy "ref" (string).

Returns None if neither key is present.

pub fn normalize_citation_attrs(&mut self)

Rewrite legacy "ref" (string) → "refs" (array) in the attributes map.

No-op if "refs" already exists or "ref" is absent.

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

Get glossary term ref, supporting both "ref" and legacy "termId".

Returns None if neither key is present.

pub fn normalize_glossary_attrs(&mut self)

Rewrite legacy "termId" → "ref" in the attributes map.

No-op if "ref" already exists or "termId" is absent.

pub fn citation(reference: impl Into<String>) -> Self

Create a citation mark (semantic extension).

pub fn citation_with_page( reference: impl Into<String>, page: impl Into<String>, ) -> Self

Create a citation mark with page locator.

pub fn multi_citation(refs: &[String]) -> Self

Create a multi-reference citation mark (e.g., [smith2023; jones2024]).

pub fn entity(uri: impl Into<String>, entity_type: impl Into<String>) -> Self

Create an entity link mark (semantic extension).

pub fn glossary(term_id: impl Into<String>) -> Self

Create a glossary reference mark (semantic extension).

pub fn index(term: impl Into<String>) -> Self

Create an index mark (presentation extension).

pub fn index_with_subterm( term: impl Into<String>, subterm: impl Into<String>, ) -> Self

Create an index mark with subterm.

pub fn equation_ref(target: impl Into<String>) -> Self

Create an equation reference mark (academic extension).

References an equation by its ID (e.g., “#eq-pythagoras”).

pub fn equation_ref_formatted( target: impl Into<String>, format: impl Into<String>, ) -> Self

Create an equation reference mark with custom format.

The format string can use {number} as a placeholder for the equation number.

pub fn algorithm_ref(target: impl Into<String>) -> Self

Create an algorithm reference mark (academic extension).

References an algorithm by its ID (e.g., “#alg-quicksort”).

pub fn algorithm_ref_line( target: impl Into<String>, line: impl Into<String>, ) -> Self

Create an algorithm reference mark with line reference.

References a specific line within an algorithm.

pub fn algorithm_ref_formatted( target: impl Into<String>, format: impl Into<String>, ) -> Self

Create an algorithm reference mark with custom format.

The format string can use {number} and {line} as placeholders.

pub fn algorithm_ref_line_formatted( target: impl Into<String>, line: impl Into<String>, format: impl Into<String>, ) -> Self

Create an algorithm reference mark with line and custom format.

pub fn theorem_ref(target: impl Into<String>) -> Self

Create a theorem reference mark (academic extension).

References a theorem by its ID (e.g., “#thm-pythagoras”).

pub fn theorem_ref_formatted( target: impl Into<String>, format: impl Into<String>, ) -> Self

Create a theorem reference mark with custom format.

The format string can use {number} and {variant} as placeholders.

pub fn highlight(color: impl Into<String>) -> Self

Create a highlight mark (collaboration extension).

Applies a colored highlight to text for collaborative annotation. Default color is yellow if not specified.

pub fn highlight_yellow() -> Self

Create a highlight mark with default yellow color.

pub fn highlight_colored(color: impl Display) -> Self

Create a highlight mark with a specific color.

Convenience method that accepts the HighlightColor display string.

Trait Implementations

impl Clone for ExtensionMark

fn clone(&self) -> ExtensionMark

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExtensionMark

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ExtensionMark

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ExtensionMark

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ExtensionMark

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ExtensionMark

impl StructuralPartialEq for ExtensionMark