MarkdigExtensions.Query 1.0.7

MarkdigExtensions.Query 📄🔍

MarkdigExtensions.Query is a powerful, jQuery-style query engine for traversing, filtering, and manipulating Markdown documents in .NET. Built on top of the Markdig Markdown parser, it provides an expressive API for searching and transforming Markdown nodes with CSS-like selectors and familiar LINQ-style chaining.

🚀 Features

• 🔎 CSS-style Selectors: Query blocks and inlines with tags (h1, link, table), attributes, wildcards, and combinators.
• 🧩 Chaining & Filtering: Use .Where(), .Select(), .NextUntil(), and more for precise control.
• ⚡ Pseudo-Selectors: Supports first-child, last-child, even, odd, nth-child(n).
• 💬 Text & HTML Access: Easily get .InnerText, .InnerHtml, .ToMarkdown() from any node.
• 🔧 Node Metadata: Use .Attr() to inspect node details like href, level, or isImage.
• 🧵 Sibling & Linear Traversals: Navigate using NextUntil, PrevUntil, or Between.

📦 Installation

Install from NuGet:

dotnet add package MarkdigExtensions.Query

🛠️ Getting Started

using Markdig;
using MarkdigExtensions.Query;

// Parse a Markdown document
var markdown = """
# Welcome to the Test Suite

This document is **bold** and ![an image](img.png).

---

## Next Section
""";

var doc = Markdown.Parse(markdown);

// Query all heading blocks
var headings = doc.QueryBlocks("h1, h2");

// Get text from the first heading
var title = headings.First().InnerText; // "Welcome to the Test Suite"

// Find all paragraphs between H1 and HR
var section = doc.QueryBlock("h1")?.NextUntil("hr");

🔍 Selector Syntax

Pseudo-classes:

• first-child
• last-child
• even
• odd
• nth-child(n)

🧠 API Overview

Query Methods

document.QueryBlocks("selector")

Returns IEnumerable<MarkdownNode>

MarkdownNode Access

node.InnerText       // Clean text content
node.InnerHtml       // HTML rendering
node.ToMarkdown()    // Original markdown
node.Attr("href")    // e.g., link URL
node.Attr()          // Dictionary of attributes

Traversal

node.NextUntil("selector", includeStart: false, includeEnd: false, blockOnly: true)
node.PrevUntil("selector")
node.Between(startNode, endNode)

🔧 Advanced Examples

Group all paragraphs between two headings

var intro = doc
    .QueryBlock("h1")
    ?.NextUntil("h2", includeStart: false, includeEnd: false);

Select all emphasized text inside a paragraph

var emphasis = doc.QueryBlock("paragraph emphasis");

Wildcard + pseudo-class combo

var firstOfEach = doc.QueryBlock("*:first-child");

✅ Use Cases

• Build markdown content editors or analyzers
• Wrap sections between headings
• Validate document structure
• Extract or transform specific content programmatically

🔗 Links

• GitHub: Zettersten/MarkdigExtensions.Query
• NuGet: MarkdigExtensions.Query on NuGet

Thanks for using MarkdigExtensions.Query! Enjoy writing powerful, expressive markdown transformations — just like jQuery for documents.