markdown-writer

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