Files
codium_nostr_extension/plans/longform-metadata-strategy.md
T
2026-07-18 17:29:20 -04:00

6.9 KiB

Long-Form Note Metadata Strategy

Goal

When publishing a .md file as a NIP-23 long-form note (kind 30023), the author needs to control metadata that is not part of the body content:

  • d tag — the parameterized-replaceable identifier (slug)
  • title — note title
  • summary — short abstract shown in feeds
  • image — cover/hero image URL
  • t tags — topics / hashtags
  • published_at — first-publish timestamp (set once, preserved on updates)
  • alt — accessibility/relay hint text

We need a way to express these per-document. Two complementary mechanisms are proposed: front-matter (primary, authoring-time) and a publish dialog (secondary, last-mile override + confirmation).

NIP-23 tag reference

Tag NIP-23 meaning Source of value
d identifier front-matter slug, else filename stem, else prompt
title title front-matter title, else filename stem
summary abstract front-matter summary, else first paragraph
image cover image URL front-matter image
t topic hashtag front-matter tags (array)
published_at first publish unix ts auto-managed by extension, persisted in workspace state keyed by d
alt relay hint auto-generated: "Long-form post: