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

HtmlToMarkdownConverter Pennington.Infrastructure

Tiny, hand-rolled HTML → Markdown converter used for llms.txt output.

Scope is deliberately minimal: the output is consumed by LLMs and doesn't need to round-trip to the original HTML. It covers headings, paragraphs, lists, links, inline/fenced code, blockquotes, images, horizontal rules, and basic inline formatting. Everything else recurses into text content.

If this grows past ~250 lines, switch to a real library (e.g. ReverseMarkdown on NuGet) rather than expanding it further.

Methods

Convert

#
public static string Convert(IElement root, Func<string, string> rewriteHref = null)

Converts root to markdown.

Parameters

root IElement
Root element whose descendants are converted.
rewriteHref Func<string, string>
Optional callback invoked for every <a href> value before it's emitted. Return the href unchanged to keep the link as-is, or a new string to replace it. Anchor-only links (#section) and empty hrefs are never passed to the callback — they're emitted as plain text regardless.

Returns

string

Pennington.Infrastructure.HtmlToMarkdownConverter

namespace Pennington.Infrastructure;

/// Tiny, hand-rolled HTML → Markdown converter used for llms.txt output. Scope is deliberately minimal: the output is consumed by LLMs and doesn't need to round-trip to the original HTML. It covers headings, paragraphs, lists, links, inline/fenced code, blockquotes, images, horizontal rules, and basic inline formatting. Everything else recurses into text content.If this grows past ~250 lines, switch to a real library (e.g. ReverseMarkdown on NuGet) rather than expanding it further.
public class HtmlToMarkdownConverter
{
    /// Converts root to markdown.
    
public static string Convert(IElement root, Func<string, string> rewriteHref = null)

;
}