Markdown Tools

The markdown-tools skill equips AI agents with the ability to read, write, and manipulate Markdown files directly within their environment. It enables seamless conversion between formats like HTML and JSON while supporting file creation and editing operations.

When to use it

• Transforming raw text logs or data exports into structured Markdown documentation for reports.
• Converting existing HTML content into clean Markdown for easier version control and rendering.
• Generating new Markdown files from scratch based on natural language instructions.
• Editing specific sections of an existing Markdown file to update notes or specifications.

Key capabilities

• Read and parse Markdown files from the local filesystem.
• Write and create new Markdown files with formatted content.
• Convert content between Markdown, HTML, and JSON formats.
• Perform direct file system operations on .md documents.

Example prompts

• "Convert this HTML snippet into a well-formatted Markdown list."
• "Create a new file called meeting-notes.md with headers for agenda items and attendees."
• "Read the existing README.md, update the installation section, and save the changes."

Tips & gotchas

Ensure the AI agent has appropriate filesystem permissions to access the directory containing your Markdown files. This skill is strictly limited to text-based file manipulation and does not execute code or render visual previews within the chat interface.