unist-util-visit

import { fromMarkdown } from 'mdast-util-from-markdown' import { visit } from 'unist-util-visit' import type { Node, Parent } from 'unist' // For type safety // Example Markdown content const markdownContent = 'Some *emphasis*, **strong**, and `code`.' // Parse the Markdown into a unist (mdast) tree const tree = fromMarkdown(markdownContent) // A type guard to refine the parent type for safer access function isParent(node: Node | undefined): node is Parent { return !!node && 'children' in node; } console.log('--- Visiting all text nodes ---') // Visit 'text' nodes in the tree visit(tree, 'text', function (node, index, parent) { // Ensure 'parent' is a Parent node for type safety if accessing its properties const parentType = isParent(parent) ? parent.type : 'root or no parent' console.log(`[ '${(node as any).value}', '${parentType}', index: ${index} ]`) }) console.log('\n--- Visiting and skipping children ---') // Example of stopping traversal for children of 'emphasis' nodes visit(tree, 'emphasis', function (node, index, parent) { const parentType = isParent(parent) ? parent.type : 'root or no parent' console.log(`Found emphasis (value: ${(node as any).value}), skipping its children. Parent: ${parentType}`) return visit.SKIP // Stop traversing children of this 'emphasis' node }) console.log('\n--- Visiting and exiting all traversal ---') // Example of exiting all traversal when a 'strong' node is found visit(tree, 'strong', function (node, index, parent) { const parentType = isParent(parent) ? parent.type : 'root or no parent' console.log(`Found strong (value: ${(node as any).value}), exiting all traversal. Parent: ${parentType}`) return visit.EXIT // Stop all traversal immediately })