A secure, LAN-accessible web viewer designed to render Markdown files into a clean, e-reader optimized interface for immediate reading across devices.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install md-viewer
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install md-viewer using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is MD Viewer?
MD Viewer is a specialized utility within the Openclaw Skills ecosystem that solves the frustration of reading raw Markdown files on small screens or e-ink devices. Instead of forcing the user to read through a summary or raw terminal text, this skill launches a localized web server that serves beautifully rendered HTML versions of your documents.
Built with a focus on accessibility and security, it automatically detects your local network IP to allow seamless cross-device viewing. The interface is specifically tuned for comfortable long-form reading, featuring high-contrast serif fonts and a light theme that excels on e-readers and mobile browsers.
MD Viewer Use Cases
- Viewing project documentation on a tablet or e-reader while coding on a primary monitor.
- Sharing technical notes instantly with other devices on the same WiFi network.
- Reviewing long-form Markdown content without cluttering the main AI chat interface.
- Reading documentation in a distraction-free, e-ink optimized browser environment.
How MD Viewer Works
- The user triggers the skill by asking to see, view, or open a specific .md file.
- The skill initializes a Python-based web server that automatically binds to the system's LAN IP address.
- A unique, secure password and an access token are generated for the session.
- The skill provides a direct URL containing an authentication token, allowing the user to bypass the login screen on their first click.
- Upon access, the server reads the file, sanitizes the content using the bleach library, and serves it as high-contrast HTML.
- A 30-day cookie is established on the viewing device to ensure subsequent visits remain authenticated without re-entering credentials.
MD Viewer Setup
To get started with this addition to your Openclaw Skills library, ensure you have the necessary Python dependencies installed:
pip3 install markdown bleach
Run the server using the default configuration to auto-detect your LAN IP:
python3 ~/.openclaw/skills/md-viewer/scripts/server.py
MD Viewer Data Schema & Taxonomy
MD Viewer prioritizes security and privacy in its data handling:
| Feature | Mechanism |
|---|---|
| File Support | Strictly limited to .md extensions; all other file types are rejected. |
| Path Security | Hardcoded blocklist prevents access to sensitive directories like ~/.ssh, /etc, and .env files. |
| History | Tracks the last 50 viewed files locally for quick navigation (can be disabled). |
| Authentication | Uses cookie-based auth valid for 30 days and URL-embedded tokens for one-time seamless entry. |
MD Viewer Advanced Features
- Auto LAN Binding: Automatically detects and binds to your network IP, removing the need to manually lookup addresses for cross-device sharing.
- E-Ink Optimization: Specific CSS styling including serif fonts and high-contrast ratios designed specifically for e-reader hardware.
- Security Hardening: Includes Content Security Policy (CSP) headers and XSS protection to ensure that rendered Markdown cannot execute malicious scripts.
- Customizable Server: Advanced CLI options allow users to specify custom ports, set manual passwords, or restrict access to localhost only for maximum privacy.
SKILL.md
Loading
Related Openclaw Skills
OpenClaw Pilot
OpenClaw Pilot is an instruction-first skill that compiles rough ideas into a human-readable blueprint and a clean, machine-ready OpenClaw execution packet.
SQL Database Toolkit
A comprehensive data analysis suite that integrates database connectivity, SQL execution, interactive visualization, and AI-powered report generation.
Graph-RAG Memory Skill
A temporal Graph-RAG system providing AI agents with persistent, queryable long-term memory through a Mixture-of-Experts knowledge graph architecture.
PDF Translator
A sophisticated translation engine that preserves complex document layouts by leveraging LaTeX reconstruction and direct arXiv source integration.
Data Sentinel Pro
An intelligent 24/7 monitoring agent that tracks website changes, product prices, and competitor updates with instant notifications.
Session Logs
A comprehensive forensic toolkit for analyzing Openclaw session history to monitor costs, tool usage, and agent regressions.
Featured*
