The Pages extension defines a kind of note that includes a long-form article, allowing users to share and link to stand-alone documents.

Within the page content, links to PawPub objects (including other pages, as well as notes, actors, etc) should not use the markup language's own link mechanism, instead they should be defined in the links array. This allows them to use in-app / local instance links instead of opening the remote instance, and makes it easier for software to discover relationships between pages. Links to other websites should use markup links as normal.

• title: string required
• content: object required
  • (media-type): string many
• links: array(object) optional default=[]
  • range: object required
    • (media-type): range¹⁾ required
  • target: uri(note)

• The content field(s) of the note can be set to an abridged preview of the page's title/content, or just a message along the lines of “published a new page,” and should include a link to the page on the original instance, so that software that doesn't support the extension will give the user a way to open the page on the remote instance instead, so they can still see it.
• When notes with an attached page are shown to users on software which supports pages, the content of the note should not be shown, instead being replaced by a localised message and a link to the page on the local instance or a button to open it in-app. Alternatively the note can be hidden entirely, if there is another sufficient way to access pages. In either case, the page itself should never be shown inline (e.g. in timelines or user profile pages).

{
"type": "note",
"plainContent": "\"Why you should use Pages\" - https://example.social/page/123",
...
"extensions": {
 
"https://pawpub.entities.org.uk/extension/pages": {
    "title": "Why you should use Pages",
    "content": {
        "text/markdown": "important reason here!!!! **wow** look at this other page",
        "text/html": "important reason here!!!! <strong>wow</strong> look at this other page",
    },
    "links": [{
        "target": "https://social.example/note/another-page",
        "range": {
            "text/markdown": "42-57",
            "text/html": "55-70"
        }
    }]
}
 
}
}