Struct Markdown

pub struct Markdown {
    pub elements: Vec<Box<dyn MarkdownElement>>,
    pub footers: Vec<Box<dyn MarkdownElement>>,
}

A markdown document.

Fields

elements: Vec<Box<dyn MarkdownElement>>

The markdown elements.

footers: Vec<Box<dyn MarkdownElement>>

The markdown footer elements.

Implementations

impl Markdown

pub fn new() -> Self

Creates a new default Markdown instance.

pub fn with( elements: Vec<Box<dyn MarkdownElement>>, footers: Vec<Box<dyn MarkdownElement>>, ) -> Self

Creates a new Markdown instance with the given elements and footers.

pub fn header( &mut self, text: impl Into<String>, level: impl ToUsize, ) -> &mut Self

Adds a header to the document.

Arguments

• text: The header’s text.
• level: The header’s level.

Panics

Panics if the header level is not valid (one to six inclusive).

pub fn header1(&mut self, text: impl Into<String>) -> &mut Self

Adds a header with level 1 to the document.

Arguments

• text: The header’s text.

pub fn header2(&mut self, text: impl Into<String>) -> &mut Self

Adds a header with level 2 to the document.

Arguments

• text: The header’s text.

pub fn header3(&mut self, text: impl Into<String>) -> &mut Self

Adds a header with level 3 to the document.

Arguments

• text: The header’s text.

pub fn header4(&mut self, text: impl Into<String>) -> &mut Self

Adds a header with level 4 to the document.

Arguments

• text: The header’s text.

pub fn header5(&mut self, text: impl Into<String>) -> &mut Self

Adds a header with level 5 to the document.

Arguments

• text: The header’s text.

pub fn header6(&mut self, text: impl Into<String>) -> &mut Self

Adds a header with level 6 to the document.

Arguments

• text: The header’s text.

pub fn list(&mut self, list: List) -> &mut Self

Adds a list to the document.

Arguments

• list: The list instance to add.

pub fn link(&mut self, link: Link) -> &mut Self

Adds a link to the document.

Arguments

• link: The link instance to add.

Note

The associated footer element is added as well if the passed link is marked as footer.

pub fn image(&mut self, image: Image) -> &mut Self

Adds an image to the document.

Argument

• image: The image instance to add.

Note

The associated footer element is added as well if the passed link is marked as footer.

pub fn paragraph(&mut self, text: impl Into<String>) -> &mut Self

Adds a paragraph to the document.

Arguments

• text: The paragraph’s text.

pub fn render(&self) -> String

Renders the markdown document to a String.

The method does render each element in order, followed by each footer.

Trait Implementations

impl Default for Markdown

fn default() -> Markdown

Returns the “default value” for a type.

impl Display for Markdown

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

Formats the value using the given formatter.