markdown-editor-with-chat

What This Skill Does

The markdown-editor-with-chat skill provides a lightweight, local-first editing environment for your markdown files. It serves as a self-contained web interface that allows you to browse, read, and modify files within a specified local directory. By utilizing a zero-dependency design, it ensures that your local environment remains uncluttered while providing modern features like live rendering previews, nested folder navigation, and file system management. Beyond basic editing, the skill includes a proxy feature that connects to an OpenClaw gateway, enabling you to bring AI-powered writing assistance directly into your local notes or documentation workflow.

Installation

To get started, ensure you have Node.js installed on your system. You can install the skill via the command line using: clawhub install openclaw/skills/skills/musketyr/markdown-editor-with-chat. Once installed, you can launch the server by navigating to the directory and running node scripts/server.mjs -f /path/to/your/markdown/files. For a more persistent setup, you can set the MARKDOWN_DIR environment variable. Ensure that your OpenClaw gateway is accessible if you intend to use the AI chat features; simply set the OPENCLAW_GATEWAY_URL and OPENCLAW_GATEWAY_TOKEN variables before starting the server.

Use Cases

This skill is perfect for users who want to manage a 'second brain' or personal wiki stored entirely as flat markdown files on their local drive. It is ideal for developers documenting project architecture, researchers organizing notes, or anyone who prefers the security of local files over cloud-based SaaS platforms. Because it is file-based, your content remains fully compatible with other tools like Obsidian, VS Code, or command-line grep utilities, giving you maximum portability.

Example Prompts

1. "Open the project README.md file in the current directory and explain the setup instructions to me."
2. "Draft a summary of these meeting notes in a new markdown file named 'summary-2023.md'."
3. "Summarize the documentation in my 'api-specs' folder and suggest potential improvements for clarity."

Tips & Limitations

The editor is intentionally minimalist to ensure speed and reliability. As a security best practice, it is designed strictly for local development and binds to localhost by default; do not expose this server to public networks. Since it uses direct filesystem access, ensure you have proper permissions for the folders you map. If you encounter issues with file updates, check that your OS file-watcher limits are sufficient for the size of your directory. Note that the chat feature requires an external OpenClaw gateway; without one, the chat functionality will remain dormant.