Skip to main content

Markdown

Struct Markdown 

Source
pub struct Markdown { /* private fields */ }
Expand description

A rendered Markdown document. Mirrors rich.markdown.Markdown.

Implementations§

Source§

impl Markdown

Source

pub fn new(source: &str) -> Self

Parse CommonMark source into renderable blocks.

Hyperlinks are on, matching rich.markdown.Markdown(hyperlinks=True). The CLI wants them off — see hyperlinks.

Choose how a [text](url) is rendered. Port of rich.markdown.Markdown(hyperlinks=…), default true.

  • true — the text becomes an OSC 8 hyperlink pointing at the URL.
  • false — the URL is written out after the text, as text (https://example.com).

The distinction is not cosmetic. An OSC 8 escape is only emitted when the console has a colour system, so with hyperlinks on a piped or NO_COLOR render drops every destination with nothing left to recover it from. That is why upstream’s rich-cli passes hyperlinks=False by default and puts the OSC 8 form behind its opt-in -y/--hyperlinks flag; a CLI built on this crate should do the same:

let opt_in = false; // set by `-y/--hyperlinks`
let md = Markdown::new("A [link](https://example.com).").hyperlinks(opt_in);

Trait Implementations§

Source§

impl Renderable for Markdown

Source§

fn rich_render( &self, console: &Console, options: &ConsoleOptions, ) -> Vec<Segment>

Source§

fn measure(&self, _console: &Console, options: &ConsoleOptions) -> Measurement

The (minimum, maximum) cell width this renderable wants. The default assumes the renderable fills the available width (e.g. Panel, Table); Text overrides it with its content width so the top-level print path can shrink to fit. Port of __rich_measure__ / Measurement.get.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.