# MD Share - Full Reference

MD Share lets anyone write or paste Markdown and instantly get a beautiful, shareable page. It supports personal libraries, folders, organizations, version history, and exports.

## Product
- Create documents at /new
- Share via /view/{slug}
- Visibility: public (indexable), unlisted (link-only), protected (password)
- Owners can edit, move between folders, and view history
- Download as Markdown or PDF

## Architecture
- Web application with authenticated API and an MCP server
- Auth: session cookies, API keys, OAuth 2.1 for MCP
- MCP server exposes document/folder tools over SSE

## SEO
- Canonical URLs per document
- Open Graph and Twitter cards
- JSON-LD: WebSite, Organization, Article
- robots.txt disallows private areas; sitemap lists public pages
- llms.txt and llms-full.txt for AI crawlers

## Accessibility
- Semantic landmarks, skip link, labeled controls
- Keyboard-navigable menus and dialogs
- Responsive layout with mobile navigation

## API examples
Create a document:
POST /api/docs
{ "title": "Hello", "content": "# Hello", "visibility": "public" }

List documents:
GET /api/docs

Move documents to a folder:
PATCH /api/docs
{ "slugs": ["abc"], "action": "move", "folderId": "folderIdOrNull" }

## MCP tools
- list_documents, get_document, create_document, update_document, delete_document
- list_folders, create_folder, move_documents

## Security
- Password-protected documents require a cookie after verification
- Organization data is scoped by active org cookie
- API keys are hashed at rest

## Links
- Home: https://mdshare.codeorch.app
- Create: https://mdshare.codeorch.app/new
- Docs: https://mdshare.codeorch.app/view/{slug}