block-types.md

Block Types

All block types derive from the base class MdBlock.

Container blocks

• MdContainerBlock does not represent a syntactic construct in the markdown document but serves as a means to combine multiple blocks into one. For example, MdDocument has a single root block that represents the entire document. To build a document that contains multiple blocks, they are wrapped in an instance of MdContainerBlock
• MdBlockQuote: Reprents a block quote The quoted content can be any other block (typically MdParagraph).
• MdListItem: Represents an list item. Whether the item an item in an ordered list or a bullet list, depdens on whether the item is added to a MdOrderedList or a MdBulletList

Leaf blocks

• MdHeading: Represents a heading. Headings can be both ATX headings or Setext headings in the output depdening on the selected serialization options.
• MdCodeBlock: Represents a fenced code block.
• MdParagraph: Represent a paragraph
• MdTable: Represents a table. Tables are not part of the CommonMark specification, but a widely adopted table format is defined as part of the GitHub Flavored Markdown specification.
  Tables can be written to the output either as GitHub Flavored Markdown tables (default) or as inline HTML tables. See Serialization Options for details.
• MdThematicBreak: Represents a thematic break

Lists

Strictly speaking, lists are neither container blocks nor leaf blocks. Lists cannot directly contain other blocks, but a sequence of MdListItem instances that in turn are container blocks.

There are two types of lists:

• MdBulletList: Represents a bullet list
• MdOrderedList: Represents a ordered list

Extension blocks

The namespace Grynwald.MarkdownGenerator.Extensions provides additional block types that implement elements supported by most Markdown renderers. Use with caution.

• MdAdmonition: Adds support for emitting admonitions for use with the "Admonitions" extension for Python Markdown.