Markdown Editor With Chat
Lightweight markdown editor with optional OpenClaw gateway chat.
- Rating
- 4.4 (31 reviews)
- Downloads
- 4,162 downloads
- Version
- 1.0.0
Overview
Lightweight markdown editor with optional OpenClaw gateway chat.
✨Key Features
Filesystem-based: Point to any directory containing markdown files
No database: Files are the source of truth
Folder navigation: Browse nested directories
Live preview: See rendered markdown as you type
Optional chat: Connect to OpenClaw gateway for AI assistance
Zero external dependencies: Pure Node.js, self-contained HTML
Complete Documentation
View Source →
Markdown Editor with Chat
A lightweight, self-contained markdown editor that serves files from a local directory with optional OpenClaw gateway chat integration.
Features
- Filesystem-based: Point to any directory containing markdown files
- No database: Files are the source of truth
- Folder navigation: Browse nested directories
- Live preview: See rendered markdown as you type
- Optional chat: Connect to OpenClaw gateway for AI assistance
- Zero external dependencies: Pure Node.js, self-contained HTML
Quick Start
# Start with CLI arguments (recommended)
node scripts/server.mjs --folder /path/to/markdown --port 3333
# Or short form
node scripts/server.mjs -f /path/to/markdown -p 3333
# With gateway chat enabled (via env vars)
export OPENCLAW_GATEWAY_URL=http://127.0.0.1:18789
export OPENCLAW_GATEWAY_TOKEN=your-token
node scripts/server.mjs -f /path/to/markdown
Then open http://localhost:3333 in your browser.
CLI Arguments
| Argument | Short | Required | Default | Description |
|---|---|---|---|---|
| --folder | -f | Yes* | - | Directory containing markdown files |
| --port | -p | No | 3333 | Server port |
| --host | -h | No | 127.0.0.1 | Server host (localhost only by default) |
| --help | No | Show help message |
MARKDOWN_DIR env var is set.Environment Variables (fallback)
| Variable | Required | Default | Description |
|---|---|---|---|
| MARKDOWN_DIR | Yes* | - | Directory containing markdown files |
| PORT | No | 3333 | Server port |
| HOST | No | 127.0.0.1 | Server host |
| OPENCLAW_GATEWAY_URL | No | - | Gateway URL for chat feature |
| OPENCLAW_GATEWAY_TOKEN | No | - | Gateway auth token |
Security
- Localhost only by default: Server binds to 127.0.0.1, rejects public IPs
- Same-origin only: No CORS headers, browser enforces same-origin policy
- Path traversal protection: Cannot access files outside MARKDOWN_DIR
- No credentials in code: All secrets via environment variables
- Gateway proxy: Tokens never exposed to browser
API Endpoints
GET /- Serves the editor UIGET /api/files- List files and foldersGET /api/files/:path- Get file contentPUT /api/files/:path- Save file contentPOST /api/files/:path- Create new filePOST /api/chat- Proxy chat to gateway (if configured)
Use Cases
- Browse and edit OpenClaw pearls
- Personal markdown wiki
- Note-taking with AI assistance
- Documentation browser
Installation
openclaw install markdown-editor-with-chat
💻Code Examples
# Start with CLI arguments (recommended)
node scripts/server.mjs --folder /path/to/markdown --port 3333
# Or short form
node scripts/server.mjs -f /path/to/markdown -p 3333
# With gateway chat enabled (via env vars)
export OPENCLAW_GATEWAY_URL=http://127.0.0.1:18789
export OPENCLAW_GATEWAY_TOKEN=your-token
node scripts/server.mjs -f /path/to/markdownTags
Quick Info
Ready to Install?
Get started with this skill in seconds
Related Skills
4claw
4claw — a moderated imageboard for AI agents.
Aap Passport
Agent Attestation Protocol - The Reverse Turing Test.
Acestep Lyrics Transcription
Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.
Adaptive Suite
A continuously adaptive skill suite that empowers Clawdbot.