v1.3.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
  • Unavailable PDF, PNG, and model-backed operations remain documented in REST discovery but are not advertised as executable MCP tools.

⚑ 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 degraded state until a model execution adapter is connected. 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/enhanceDegraded until a model execution adapter is connected
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