# MarkdownTree

Browser-first Markdown editor, live preview, structure analyzer, graph viewer, and public Markdown API for the PlatPhormNews web mesh.

## Product Purpose

MarkdownTree is the canonical Markdown editor and document-structure utility for the PlatPhormNews web mesh. It lets humans and agents write, paste, inspect, format, preview, graph, analyze, export, share, and reason over Markdown documents.

## Public Phase 1 Capabilities

- Browser-first Markdown editing with local non-sensitive draft persistence.
- Real Markdown parsing into graph nodes and edges.
- Outline generation from actual headings.
- Live sanitized HTML preview.
- Document stats for words, lines, headings, links, images, code blocks, nodes, and edges.
- Editor, split, graph, and preview modes.
- Public REST endpoints for parse, transform, outline, stats, Markdown export, HTML export, JSON export, and bounded URL-only sharing.
- Public read-only MCP introspection and bounded Markdown MCP tools.

## Export Capability State

- Active: Markdown, HTML, JSON.
- Degraded: PDF export and PNG graph export are scaffolded but unavailable in Phase 1.
- Share URLs: URL-only and size-bounded; Markdown content is not stored server-side.

## Model Capability State

- Status: degraded
- Provider: none
- Message: No backend model provider is configured. AI writing assistance is unavailable; deterministic Markdown tools still work.
- Deterministic fallback: table of contents generation from real headings.

## Auth Policy

- Public-safe Phase 1 flows are open by default.
- Enforcement flag: PLATPHORM_REQUIRE_API_KEY=false.
- Future protected actions accept only Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key.
- PLATPHORM_API_KEY is never stored in browser local drafts, exports, traces, RSS, sitemap, or discovery files.

## Core Endpoints

- GET /api/health
- GET /api/v1/health
- GET /api/docs
- GET /openapi.json
- GET /openapi.yaml
- POST /api/v1/parse
- POST /api/v1/transform
- POST /api/v1/outline
- POST /api/v1/stats
- POST /api/v1/export
- POST /api/v1/export/html
- POST /api/v1/export/json
- POST /api/v1/export/pdf
- POST /api/v1/export/png
- POST /api/v1/share
- GET /api/mcp
- POST /api/mcp

## MCP

- Tools: 20
- Resources: 8
- Prompts: 9
- JSON-RPC 2.0 endpoint: https://markdown.platphormnews.com/api/mcp

## Discovery Routes

- / - MarkdownTree
- /editor - MarkdownTree Editor
- /docs - MarkdownTree Docs
- /api/docs - MarkdownTree API Docs
- /faq - MarkdownTree FAQ
- /privacy - Privacy
- /terms - Terms
- /accessibility - Accessibility
- /open-source - Open Source
- /llms.txt - LLMS Summary
- /llms-index.json - LLMS Index
- /openapi.yaml - OpenAPI YAML
- /openapi.json - OpenAPI JSON
- /rss.xml - RSS
- /feed.xml - Feed
- /.well-known/mcp.json - MCP Well-Known
- /.well-known/trust.json - Trust Policy

## Trace And Integrations

Markdown operations emit W3C trace response headers and safe PlatPhorm trace metadata. External Trace export is currently degraded unless a protected trace exporter is configured.

Web dashboard, public-safe discovery, browser-based operations, trusted-domain discovery, standard route compliance, Vercel metadata capture, trace inspection, and agentic workflow discovery are intentionally supported for public read-only debugging and operator workflows. Mutating, administrative, ingestion, replay, fork, remediation, deployment, sync, test-triggering, reporting, and write actions require PLATPHORM_API_KEY. Browser-local Markdown editing, graph visualization, formatting, preview, and non-sensitive draft persistence remain public product capabilities. Server-side exports, AI enhancement calls, webhook mutation, and document persistence are protected actions.