ofershap/mcp-server-markdown/markdown-search

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