Pennington.Markdown.MarkdownLinkResolver

namespace Pennington.Markdown;

/// Resolves author-written relative links inside markdown bodies to absolute canonical URLs. Handles three cases: 
../how-to/foo.md — rewrites to the canonical URL of the target markdown file and strips the .md suffix.
sample-post (no extension) — treated as a sibling markdown reference, resolved against the source file's directory and looked up by trying common extensions.
./image.png or other non-markdown relative assets — resolved against the source file's directory and emitted as an absolute URL relative to the owning content source's base URL.
 The index is built lazily from all registered IContentService instances. When managed by FileWatchDependencyFactory, the instance is recreated on file changes so the index stays fresh.
public class MarkdownLinkResolver
{
    /// Creates the resolver; the link index is built lazily on first resolution.
    
public MarkdownLinkResolver(IEnumerable<IContentService> contentServices)
;

    /// Called on the file-watcher thread for every watched change. Must be quick and thread-safe.
    
public FileWatchResponse OnFileChanged(FileChangeNotification change)
;

    /// Resolve a markdown-author-written href against the source file that contains it. Returns the rewritten href, or null if the href is external / absolute / unresolvable and should be left untouched.
    
public ValueTask<string> ResolveAsync(FilePath sourceFile, string href)
;
}