Remarks

Each event in a blog's corresponding markwhen document is a remarking entry (or "remark").

Whenever a cloud markwhen document is edited in Meridiem, it is wholly reparsed, its events sorted chronologically, and each event is given a unique id, derived primarily from the content of the first line of the event.

const disallowedCharacters = /[^A-Za-z0-9_-]/g;
const linkRegex = /(?<preceding>^|\s)\[(?<title>[^\]]*)\]\((?<url>\S+\.\S+)\)/g;
function urlFromString(s: string): string {
  return s
    .trim()
    .replaceAll(linkRegex, (orig, preceding, title) => preceding + title)
    .split(" ")
    .slice(0, 4)
    .map((s) => s.replaceAll(disallowedCharacters, ""))
    .filter((s) => !!s)
    .join("-");
}

Why not use user-defined ids from event properties?

User-defined ids are not necessarily unique. Furthermore this would require users to manually id all their events, which would be onerous.

So the following markwhen document would generate two remarks, with ids A-long-time-ago and Hello-world:

2025-06-21: A long time ago, in a galaxy far, far away
2023-04-09: Hello world!

If this markwhen document was owned by terry and the name of the doc was vacation, one could refer to a specific entry like remark.ing/terry/vacation/A-long-time-ago. This is how Remark.ing works and how remark urls are generated.

Drafts

A remark may be marked as a draft with a simple addition to its properties:

2028-05-04: Not ready for prime time yet
remarking:
  draft: true

If an entry is marked as a draft, it will not show up in yours or others' feeds.