
Markdown Search
- 1 installs
- 4 repo stars
- Updated March 10, 2026
- ofershap/mcp-server-markdown
Searches and extracts content from local Markdown files over MCP: full-text search, section extraction by heading, headings TOC, code-block finder, and frontmatter parsing.
About
This skill provides MCP tools that understand Markdown structure to search docs, pull sections by heading, list headings, find code blocks by language, and parse YAML frontmatter. A developer uses it to navigate documentation and knowledge bases.
- get_section extracts a heading's content until the next same-level heading
- Structure-aware, unlike a plain filesystem MCP
Markdown Search by the numbers
- 1 all-time installs (skills.sh)
- Ranked #1,366 of 1,879 Documentation skills by installs in the Skillselion catalog
- Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/ofershap/mcp-server-markdown --skill markdown-searchAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1 |
|---|---|
| repo stars | ★ 4 |
| Last updated | March 10, 2026 |
| Repository | ofershap/mcp-server-markdown ↗ |
What it does
Searches and extracts content from local Markdown files over MCP: full-text search, section extraction by heading, headings TOC, code-block finder, and frontmatter parsing.
Files
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
| Tool | What it does |
|---|---|
list_files | List all .md files in a directory recursively |
search_docs | Full-text search across all .md files (case-insensitive, up to 50 results) |
get_section | Extract a section by heading until the next heading of same/higher level |
list_headings | List all headings as a table of contents |
find_code_blocks | Find fenced code blocks, optionally filter by language |
get_frontmatter | Parse YAML frontmatter metadata from a file |
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_sectionextracts everything under a heading until the next heading of same or higher levelfind_code_blockswithlanguage: "typescript"filters to only TS examplessearch_docsis case-insensitive and returns up to 50 matches with surrounding context- Unlike the filesystem MCP, this server understands markdown structure (headings, sections, code fences)