| name | va-md-preview |
| description | Codex only: preview a markdown file from a Codex session with beautiful GitHub-style rendering. Use after creating or updating markdown documents like README, docs, or reports. Only available when the VibeAround MCP server is connected. |
VibeAround Markdown Preview
After you create or update a markdown document, generate a styled preview so the user can read it in their browser or phone with beautiful formatting.
When to Use
- You just created or updated a README.md, documentation, or any .md file
- The user asks to "show me the doc", "preview the README", or "let me see it"
- Only when the VibeAround MCP server is connected
Proactive behavior: After creating or updating any markdown file, proactively ask the user if they'd like to preview it (e.g. "Want me to generate a preview link so you can see it?"). If the user confirms, call md_preview. Do NOT call the tool without asking first.
Prerequisites
The VibeAround MCP server must be connected (server name: vibearound). If not available, tell the user to start the VibeAround desktop app.
Steps
1. Call md_preview
Tool: md_preview
Server: vibearound
Arguments:
file: "<path to the markdown file>" (absolute or relative to cwd)
cwd: "<current working directory>"
title: "<document title>" (optional, defaults to filename)
If the tool says the workspace is not registered, call register_workspace with the cwd first, then retry.
2. Present BOTH links to the user
The tool returns an Owner link and a Share link. Always show both in this format:
Markdown preview 已就绪：
- 你的预览: <owner_url>
- 分享链接: <share_url>（10 分钟有效）
Or in English:
Markdown preview ready:
- Owner: <owner_url>
- Share: <share_url> (expires in 10 min)
Never omit either link. The owner link is permanent. The share link is temporary and needs no auth.
Error Handling
- MCP server not available: The VibeAround desktop app may not be running.
- Workspace not registered: Call
register_workspace first, then retry.
- File not found: Verify the file path is correct and the file exists.
