Figures
editFigures gives an image, a diagram, a table or a code sample a caption: blocks between a fence of three carets or more, ^^^, and a fence as long are rendered as <figure>, and the text after a fence as <figcaption>.
var options = new MarkdownParseOptions { Extensions = MarkdownExtensions.Figures };
var tree = MarkdownSyntaxTree.ParseText("^^^\n\n^^^ The *logo*\n", options);
var figure = Assert.IsType<MarkdownFigureSyntax>(tree.GetRoot().Blocks.Single());
Assert.Equal("The logo", figure.Blocks.OfType<MarkdownFigureCaptionSyntax>().Single().GetPlainText());
Assert.Equal("<figure>\n<p><img src=\"logo.png\" alt=\"Logo\" /></p>\n<figcaption>The <em>logo</em></figcaption>\n</figure>\n", MarkdownHtmlRenderer.ToHtml(tree));A figure is a MarkdownFigureSyntax, and its caption a MarkdownFigureCaptionSyntax. The text after the opening fence is a caption before the content, and the text after the closing fence a caption after it.