mdshare — Compartilhador de Markdown Renderizado
RileyLin/mdshare
Converta markdown em URLs bonitas para compartilhar análises de IA
Ver no GitHubMCP Server que converte markdown em URLs compartilháveis com renderização visual limpa e automática. Integra-se nativamente ao Claude Desktop e qualquer agente compatível com MCP, permitindo que IA compartilhe análises, diagramas Mermaid e conteúdo formatado instantaneamente. Ideal para distribuir relatórios, documentação e visualizações sem perder formatação.
Instalação
npx convez-ai RileyLin/mdshare1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Compartilhar relatórios e análises do Claude com colegas via link
- Renderizar diagramas Mermaid automaticamente em markdown
- Distribuir documentação formatada sem perder estrutura em Slack/email
Veredito

Ferramenta prática que resolve um problema real: markdown fica feio quando compartilhado em canais informais. A integração MCP é bem executada e o suporte a diagramas Mermaid agrega valor. Recomendado para equipes que usam Claude para análises e precisam compartilhar resultados visualmente.
README
A tradução para o português deste README ainda está na fila.
mdshare
Turn any markdown into a shareable link — instantly.
The Problem
You write a great response in Claude, ChatGPT, or your terminal — full of headers, code blocks, and bullet lists — and then you paste it into Slack or iMessage and it looks like garbage. Raw markdown everywhere.
mdshare fixes this. POST your markdown, get a clean rendered URL back. Share that URL anywhere.
Quick Start
curl -X POST https://mdshare-rileylins-projects.vercel.app/api/share \
-H "Content-Type: application/json" \
-d '{"markdown": "# Hello\n\nThis is **rendered** markdown with `code` and everything."}'
Response:
{
"url": "https://mdshare-rileylins-projects.vercel.app/v/abc123",
"id": "abc123",
"expires_in": 86400
}
Open the URL in any browser and you get a beautiful GitHub-styled page. Share it in Slack, iMessage, email — it just works.
MCP Server (for Claude Desktop & AI Assistants)
The mdshare-mcp package lets Claude (and any MCP-compatible AI) share markdown directly from a conversation.
Install
npm install -g mdshare-mcp
Configure Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"mdshare": {
"command": "mdshare-mcp"
}
}
}
Config file locations:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
Restart Claude Desktop. You'll see share_markdown available in the tools panel.
What Claude can do with it
"Share this analysis as a link I can send to my team"
Claude will call share_markdown with the content and return a URL you can paste anywhere.
"Draw the system architecture as a diagram"
Claude includes a ```mermaid block in the markdown — it renders as an interactive SVG on the page.
"Share this custom SVG chart"
Claude calls share_diagram with raw SVG markup for fully custom visuals.
MCP Tools
| Tool | Description |
|---|---|
share_markdown | Share markdown (with optional Mermaid diagrams) as a rendered page |
share_diagram | Share a standalone SVG diagram with optional notes |
API Reference
POST /api/share
Share a markdown document and get a short-lived URL.
Request body:
{
"markdown": "string (required)",
"ttl": 86400
}
| Field | Type | Required | Description |
|---|---|---|---|
markdown | string | ✅ | Markdown content to render |
ttl | number | ❌ | TTL in seconds. Default: 86400 (24h) |
Response:
{
"url": "https://mdshare-rileylins-projects.vercel.app/v/:id",
"id": "string",
"expires_in": 86400
}
Mermaid Diagrams in Markdown
mdshare renders Mermaid diagrams automatically. Use fenced code blocks with the mermaid language tag:
```mermaid
graph TD
A[User] --> B[API Gateway]
B --> C[Lambda]
C --> D[DynamoDB]
```
Supported diagram types: flowcharts, sequence diagrams, class diagrams, state diagrams, ER diagrams, Gantt charts, pie charts, and more. See Mermaid docs for full syntax.
Diagrams render client-side with Mermaid v11, support dark/light themes automatically, and work alongside regular markdown content (tables, code blocks, text).
POST /api/diagram
Share a standalone SVG diagram (for fully custom visuals that Mermaid can't express).
Request body:
{
"svg": "<svg>...</svg> (required)",
"title": "My Diagram",
"markdown": "Optional companion notes (rendered below the diagram)",
"ttl": 86400
}
| Field | Type | Required | Description |
|---|---|---|---|
svg | string | ✅ | Valid SVG markup |
title | string | ❌ | Diagram title. Default: "Diagram" |
markdown | string | ❌ | Markdown notes shown below the SVG |
ttl | number | ❌ | TTL in seconds. Default: 86400 (24h), max: 604800 (7 days) |
Response:
{
"url": "https://mdshare-rileylins-projects.vercel.app/d/:id",
"id": "string",
"expires_in": 86400
}
GET /v/:id
View a shared markdown document. Returns a rendered HTML page with:
- GitHub-flavored markdown styling
- Syntax highlighting (highlight.js)
- Mermaid diagram rendering
- Dark/light theme toggle
- Proper typography (Instrument Serif + DM Sans)
GET /d/:id
View a shared SVG diagram. Dark canvas theme with optional markdown notes below.
GET /api/diagram?id=xxx
Get the raw SVG for a stored diagram (returns image/svg+xml).
GET /raw/:id
Get the raw markdown source for a shared document.
Self-Host
mdshare is a zero-dependency Next.js app. Deploy your own instance in 60 seconds:
Environment variables (optional):
| Variable | Default | Description |
|---|---|---|
DEFAULT_TTL | 86400 | Default document TTL in seconds |
MAX_TTL | 604800 | Maximum allowed TTL (7 days) |
After deploying, update the MDSHARE_API in your MCP server config to point at your own instance:
{
"mcpServers": {
"mdshare": {
"command": "mdshare-mcp",
"env": {
"MDSHARE_API": "https://your-instance.vercel.app/api/share"
}
}
}
}
Tech Stack
- Frontend: Next.js 14 (App Router)
- Rendering: marked + GitHub CSS
- Syntax highlighting: highlight.js
- Storage: Supabase (Postgres)
- Hosting: Vercel
- MCP: @modelcontextprotocol/sdk
Development
git clone https://github.com/RileyLin/mdshare.git
cd mdshare/app
npm install
npm run dev
Open http://localhost:3000.
Project Structure
app/
├── api/ # Vercel serverless functions
│ └── share/ # POST /api/share endpoint
├── public/ # Static assets
├── mcp/ # MCP server (mdshare-mcp npm package)
│ └── src/
│ └── index.ts
└── vercel.json
License
MIT © Riley Lin