v1.0.0

πŸ“š Documentation

Learn how to use MarkdownTree and integrate with our API and MCP endpoints.

πŸ”Œ MCP Integration

MarkdownTree is fully compatible with the Model Context Protocol (MCP). Connect agents, LLM workflows, and automation tools to MarkdownTree's real Markdown parsing, graph, outline, stats, and export capabilities.

🌐 MCP Discovery Endpoint

GET https://markdown.platphormnews.com/.well-known/mcp.json

πŸ€– MCP Client Portal

Use the Platphorm MCP Client to connect agents and tools:

mcp.platphormnews.com

πŸ“‹ Available MCP Tools

  • β€’ parse_markdown β€” Parse Markdown content into graph, outline, and stats data
  • β€’ export_html β€” Export sanitized standalone HTML
  • β€’ export_json β€” Export structured Markdown graph JSON
  • β€’ generate_table_of_contents β€” Generate a deterministic TOC from real headings
  • β€’ export_pdf / export_png β€” Return degraded unavailable states until implemented

⚑ Quick Start

πŸ“Š Transform Markdown to Graph

curl -X POST https://markdown.platphormnews.com/api/v1/transform \
  -H "Content-Type: application/json" \
  -d '{"markdown": "# Hello\n\nWorld"}'

πŸ“€ Export Document

curl -X POST https://markdown.platphormnews.com/api/v1/export \
  -H "Content-Type: application/json" \
  -d '{"markdown": "# Doc", "format": "html"}'

πŸ€– AI Enhancement

curl -X POST https://markdown.platphormnews.com/api/v1/ai/enhance \
  -H "Content-Type: application/json" \
  -d '{"markdown": "# Draft", "action": "improve"}'

This returns an honest model-unavailable state unless a backend provider is configured. Deterministic table-of-contents generation is available at /api/v1/ai/toc.

πŸ“‘ Endpoints

MethodEndpointDescription
GET
/api/healthπŸ’š Health check
GET
/api/docsπŸ“„ OpenAPI spec
POST
/api/v1/parseParse Markdown to graph, outline, and stats
POST
/api/v1/transformTransform Markdown to graph
POST
/api/v1/exportExport Markdown, HTML, JSON, or degraded PDF/PNG state
POST
/api/v1/ai/enhanceModel-backed enhancement when configured; degraded otherwise
POST
/api/v1/ai/chatπŸ’¬ AI chat assistant

🌐 Internationalization

MarkdownTree includes built-in I18N support. The interface automatically detects your browser language and supports:

πŸ‡ΊπŸ‡ΈEnglishπŸ‡ͺπŸ‡ΈEspaΓ±olπŸ‡«πŸ‡·FranΓ§aisπŸ‡©πŸ‡ͺDeutschπŸ‡―πŸ‡΅ζ—₯本θͺžπŸ‡¨πŸ‡³δΈ­ζ–‡

πŸ“Ž Resources