This documentation is also published as Markdown for efficient machine reading: the whole site is indexed at /llms.txt, and every page has a clean Markdown copy under /_llms/. These are generated from the same source and cost far fewer tokens to read than this rendered HTML.

Skip to main content Skip to navigation

MarkdownContentRenderer Pennington.Markdown

Renders parsed markdown items to HTML using Markdig. After rendering, relative author-written links (e.g. ../how-to/foo.md, sample-post, ./image.png) are rewritten to absolute canonical URLs via MarkdownLinkResolver.

Constructors

MarkdownContentRenderer

#
public MarkdownContentRenderer(MarkdownPipeline pipeline = null, MarkdownLinkResolver linkResolver = null, IFileSystem fileSystem = null, ShortcodeExpander shortcodeExpander = null)

Creates the renderer; the default Markdig pipeline is used when none is supplied.

Parameters

pipeline MarkdownPipeline
Markdig pipeline; defaults to CreateDefault.
linkResolver MarkdownLinkResolver
Resolves author-written relative links to canonical URLs.
fileSystem IFileSystem
Backs [!INCLUDE] expansion; includes are skipped when null.
shortcodeExpander ShortcodeExpander
Expands <?# Name ... ?> shortcodes before Markdig parses; shortcodes are skipped when null.

Methods

RenderAsync

#
public Task<ContentItem> RenderAsync(ParsedItem item)

Render a parsed item. Returns RenderedItem on success, FailedItem on failure.

Parameters

item ParsedItem

Returns

Task<ContentItem>

Pennington.Markdown.MarkdownContentRenderer

namespace Pennington.Markdown;

/// Renders parsed markdown items to HTML using Markdig. After rendering, relative author-written links (e.g. ../how-to/foo.md, sample-post, ./image.png) are rewritten to absolute canonical URLs via MarkdownLinkResolver.
public class MarkdownContentRenderer
{
    /// Creates the renderer; the default Markdig pipeline is used when none is supplied.
    
public MarkdownContentRenderer(MarkdownPipeline pipeline = null, MarkdownLinkResolver linkResolver = null, IFileSystem fileSystem = null, ShortcodeExpander shortcodeExpander = null)
; /// Render a parsed item. Returns RenderedItem on success, FailedItem on failure.
public Task<ContentItem> RenderAsync(ParsedItem item)
; }