Markdown Writer

Write markdown content to disk reliably using the MCP markdown-writer server with atomic writes and verification.

Usage

Write a file

Use the mcp__markdown-writer__write tool directly:

Example:

Use mcp__markdown-writer__write to write the following content to /path/to/file.md:

# Your Markdown Content

Multi-line content works fine.

## Sections supported
- Lists
- Code blocks
- All markdown features

Parameters:

• •path: Absolute path (e.g., /tmp/test.md) or relative path from repository root (e.g., docs/test.md)
• •content: Markdown content to write

Verify a file (optional)

Use the mcp__markdown-writer__verify tool:

Example:

Use mcp__markdown-writer__verify to check /path/to/file.md

Parameters:

• •path: Absolute path (e.g., /tmp/test.md) or relative path from repository root (e.g., docs/test.md)

Key Behaviors

• •Creates parent directories automatically
• •Overwrites existing files without prompting
• •Atomic writes via temporary files and rename
• •Supports absolute paths (e.g., /tmp/file.md) and relative paths from repository root (e.g., docs/file.md)
• •Path validation prevents traversal attacks (../)
• •Returns file size and statistics

When to Use This Skill

Use this skill when:

• •You need to write markdown files from within an agent/subagent
• •The Write tool is restricted or unavailable
• •You need guaranteed atomic writes
• •You're generating documentation, reports, or research outputs
• •You want to avoid user permission prompts for file writes

Notes

• •The MCP server handles all file operations
• •No external Python dependencies required
• •All operations are logged for debugging