name: markdown-search description: Search and navigate local markdown via MCP. Use when the user asks to search docs, find a README section, list headings/TOC, extract code examples by language, read frontmatter, or grep internal wikis and ADRs on disk. metadata: version: "1.0.0"

Markdown Search via MCP

Use this skill when you need to search documentation, extract sections, list headings, or find code blocks across local markdown files.

Available Tools

Workflow

1. list_files to discover documentation files in the project
2. search_docs for full-text search across all docs
3. list_headings to get the table of contents for a specific file
4. get_section to extract a specific section by its heading text
5. find_code_blocks to find code examples, optionally filtered by language

Key Patterns

• get_section extracts everything under a heading until the next heading of same or higher level
• find_code_blocks with language: "typescript" filters to only TS examples
• search_docs is case-insensitive and returns up to 50 matches with surrounding context
• Unlike the filesystem MCP, this server understands markdown structure (headings, sections, code fences)

Error Scenarios

• No matches from search_docs: widen the query, check the directory path, or confirm files use .md extension
• get_section not found: heading text must match (including # level); use list_headings first
• Permission or missing path errors: verify the directory exists and is readable on the host running the MCP server
• More than 50 search hits: refine the query or search a smaller subdirectory