# com.pagehare.content.markdown

> Published by [pagehare.com](https://lexicon.garden/identity/did:plc:wmpvkel5rsifjqzlxg7447ua)

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:wmpvkel5rsifjqzlxg7447ua/com.pagehare.content.markdown)
- [Documentation](https://lexicon.garden/lexicon/did:plc:wmpvkel5rsifjqzlxg7447ua/com.pagehare.content.markdown/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:wmpvkel5rsifjqzlxg7447ua/com.pagehare.content.markdown/examples)

## Definitions

### `com.pagehare.content.markdown#cover`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `alt` | `string` | Yes | Image description; empty for a decorative cover. |
| `url` | `string` (uri) | Yes | Absolute HTTPS URL of a hosted image. |

### `com.pagehare.content.markdown`

**Type**: `object`

Canonical markdown content for a site.standard.document, embedded in the document's open content union. The markdown string is the canonical article body; optional cover metadata is stored alongside it; the document's textContent and the com.pagehare.facets / com.pagehare.embeds sidecars are derived projections regenerated from it on every write. Note: at.markpub.markdown is tracked as a potential community successor $type once it stabilizes — only this wrapper $type would migrate, never the payload.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `cover` | `ref` → `#cover` | No | Optional cover image metadata, separate from the markdown body. |
| `markdown` | `string` | Yes | GitHub-Flavored Markdown source. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "cover": {
      "properties": {
        "alt": {
          "description": "Image description; empty for a decorative cover.",
          "type": "string"
        },
        "url": {
          "description": "Absolute HTTPS URL of a hosted image.",
          "format": "uri",
          "type": "string"
        }
      },
      "required": [
        "url",
        "alt"
      ],
      "type": "object"
    },
    "main": {
      "description": "Canonical markdown content for a site.standard.document, embedded in the document's open content union. The markdown string is the canonical article body; optional cover metadata is stored alongside it; the document's textContent and the com.pagehare.facets / com.pagehare.embeds sidecars are derived projections regenerated from it on every write. Note: at.markpub.markdown is tracked as a potential community successor $type once it stabilizes — only this wrapper $type would migrate, never the payload.",
      "properties": {
        "cover": {
          "description": "Optional cover image metadata, separate from the markdown body.",
          "ref": "#cover",
          "type": "ref"
        },
        "markdown": {
          "description": "GitHub-Flavored Markdown source.",
          "maxGraphemes": 500000,
          "maxLength": 1000000,
          "type": "string"
        }
      },
      "required": [
        "markdown"
      ],
      "type": "object"
    }
  },
  "id": "com.pagehare.content.markdown",
  "lexicon": 1
}
```