convez.ai
MCP ServerIntegração & APIsIntermediário
RileyLin

mdshare — Compartilhador de Markdown Renderizado

RileyLin/mdshare

Converta markdown em URLs bonitas para compartilhar análises de IA

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP 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/mdshare

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
1

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.

Deploy with Vercel License: MIT


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

ToolDescription
share_markdownShare markdown (with optional Mermaid diagrams) as a rendered page
share_diagramShare 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
}
FieldTypeRequiredDescription
markdownstring✅Markdown content to render
ttlnumber❌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
}
FieldTypeRequiredDescription
svgstring✅Valid SVG markup
titlestring❌Diagram title. Default: "Diagram"
markdownstring❌Markdown notes shown below the SVG
ttlnumber❌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:

Deploy with Vercel

Environment variables (optional):

VariableDefaultDescription
DEFAULT_TTL86400Default document TTL in seconds
MAX_TTL604800Maximum 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


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

Ver o original no GitHub

Bom para

Relacionados