Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
ofershap avatar

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-search

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs1
repo stars4
Last updatedMarch 10, 2026
Repositoryofershap/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

SKILL.mdMarkdownGitHub ↗

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

ToolWhat it does
list_filesList all .md files in a directory recursively
search_docsFull-text search across all .md files (case-insensitive, up to 50 results)
get_sectionExtract a section by heading until the next heading of same/higher level
list_headingsList all headings as a table of contents
find_code_blocksFind fenced code blocks, optionally filter by language
get_frontmatterParse 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_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)

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.