markdown-writer
使用MCP markdown-writer服务器将markdown内容写入文件路径。当需要将生成的markdown内容保存到文件时使用,特别是在以下情况下:(1)Write工具不可用或受限,(2)需要保证的原子写入和验证,(3)为文档、报告或研究输出编写markdown文件,(4)代理需要在没有用户权限提示的情况下持久化markdown。
📖 中文导读:使用MCP markdown-writer服务器将markdown内容写入文件路径。当需要将生成的markdown内容保存到文件时使用,特别是在以下情况下:(1)Write工具不可用或受限,(2)需要保证的原子写入和验证,(3)为文档、报告或研究输出编写markdown文件,(4)代理需要在没有用户权限提示的情况下持久化markdown。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: markdown-writer description: Write markdown content to file paths using the MCP markdown-writer server. Use when you need to save generated markdown content to a file, especially in contexts where (1) The Write tool is unavailable or restricted, (2) You need guaranteed atomic writes with verification, (3) Writing markdown files for documentation, reports, or research outputs, (4) An agent needs to persist markdown without user permission prompts. allowed-tools: mcp__markdown-writer__write, mcp__markdown-writer__verify
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