rich.markdown

class rich.markdown.BlockQuote

A block quote.

on_child_close(context: rich.markdown.MarkdownContext, child: rich.markdown.MarkdownElement) → bool

Called when a child element is closed.

This method allows a parent element to take over rendering of its children.

Parameters

• context (MarkdownContext) – The markdown context.

• child (MarkdownElement) – The child markdown element.

Returns

Return True to render the element, or False to not render the element.

Return type

bool

class rich.markdown.CodeBlock(lexer_name: str, theme: str)

A code block with syntax highlighting.

classmethod create(markdown: rich.markdown.Markdown, node: Any) → rich.markdown.CodeBlock

Factory to create markdown element,

Parameters

• markdown (Markdown) – THe parent Markdown object.

• node (Any) – A node from Pygments.

Returns

A new markdown element

Return type

MarkdownElement

class rich.markdown.Heading(level: int)

A heading.

classmethod create(markdown: rich.markdown.Markdown, node: Any) → rich.markdown.Heading

Factory to create markdown element,

Parameters

• markdown (Markdown) – THe parent Markdown object.

• node (Any) – A node from Pygments.

Returns

A new markdown element

Return type

MarkdownElement

on_enter(context: rich.markdown.MarkdownContext) → None

Called when the node is entered.

Parameters

context (MarkdownContext) – The markdown context.

class rich.markdown.HorizontalRule

A horizontal rule to divide sections.

class rich.markdown.ImageItem(destination: str, hyperlinks: bool)

Renders a placeholder for an image.

classmethod create(markdown: rich.markdown.Markdown, node: Any) → rich.markdown.MarkdownElement

Factory to create markdown element,

Parameters

• markdown (Markdown) – THe parent Markdown object.

• node (Any) – A node from Pygments.

Returns

A new markdown element

Return type

MarkdownElement

on_enter(context: rich.markdown.MarkdownContext) → None

Called when the node is entered.

Parameters

context (MarkdownContext) – The markdown context.

class rich.markdown.ListElement(list_type: str, list_start: Optional[int])

A list element.

classmethod create(markdown: rich.markdown.Markdown, node: Any) → rich.markdown.ListElement

Factory to create markdown element,

Parameters

• markdown (Markdown) – THe parent Markdown object.

• node (Any) – A node from Pygments.

Returns

A new markdown element

Return type

MarkdownElement

on_child_close(context: rich.markdown.MarkdownContext, child: rich.markdown.MarkdownElement) → bool

Called when a child element is closed.

This method allows a parent element to take over rendering of its children.

Parameters

• context (MarkdownContext) – The markdown context.

• child (MarkdownElement) – The child markdown element.

Returns

Return True to render the element, or False to not render the element.

Return type

bool

class rich.markdown.ListItem

An item in a list.

on_child_close(context: rich.markdown.MarkdownContext, child: rich.markdown.MarkdownElement) → bool

Called when a child element is closed.

This method allows a parent element to take over rendering of its children.

Parameters

• context (MarkdownContext) – The markdown context.

• child (MarkdownElement) – The child markdown element.

Returns

Return True to render the element, or False to not render the element.

Return type

bool

class rich.markdown.Markdown(markup: str, code_theme: str = 'monokai', justify: Optional[typing_extensions.Literal[default, left, center, right, full]] = None, style: Union[str, rich.style.Style] = 'none', hyperlinks: bool = True, inline_code_lexer: Optional[str] = None, inline_code_theme: Optional[str] = None)

A Markdown renderable.

Parameters

• markup (str) – A string containing markdown.

• code_theme (str, optional) – Pygments theme for code blocks. Defaults to “monokai”.

• justify (JustifyMethod, optional) – Justify value for paragraphs. Defaults to None.

• style (Union[str, Style], optional) – Optional style to apply to markdown.

• hyperlinks (bool, optional) – Enable hyperlinks. Defaults to True.

• inline_code_lexer – (str, optional): Lexer to use if inline code highlighting is enabled. Defaults to “python”.

• inline_code_theme – (Optional[str], optional): Pygments theme for inline code highlighting, or None for no highlighting. Defaults to None.

class rich.markdown.MarkdownContext(console: rich.console.Console, options: rich.console.ConsoleOptions, style: rich.style.Style, inline_code_lexer: Optional[str] = None, inline_code_theme: str = 'monokai')

Manages the console render state.

property current_style: rich.style.Style

Current style which is the product of all styles on the stack.

enter_style(style_name: Union[str, rich.style.Style]) → rich.style.Style

Enter a style context.

leave_style() → rich.style.Style

Leave a style context.

on_text(text: str, node_type: str) → None

Called when the parser visits text.

class rich.markdown.Paragraph(justify: typing_extensions.Literal[default, left, center, right, full])

A Paragraph.

classmethod create(markdown: rich.markdown.Markdown, node: rich.markdown.MarkdownElement) → rich.markdown.Paragraph

Factory to create markdown element,

Parameters

• markdown (Markdown) – THe parent Markdown object.

• node (Any) – A node from Pygments.

Returns

A new markdown element

Return type

MarkdownElement

class rich.markdown.TextElement

Base class for elements that render text.

on_enter(context: rich.markdown.MarkdownContext) → None

Called when the node is entered.

Parameters

context (MarkdownContext) – The markdown context.

on_leave(context: rich.markdown.MarkdownContext) → None

Called when the parser leaves the element.

Parameters

context (MarkdownContext) – [description]

on_text(context: rich.markdown.MarkdownContext, text: Union[str, rich.text.Text]) → None

Called when text is parsed.

Parameters

context (MarkdownContext) – The markdown context.

class rich.markdown.UnknownElement

An unknown element.

Hopefully there will be no unknown elements, and we will have a MarkdownElement for everything in the document.