Wiki
Wiki articles are minimal addressable events for collaborative, hyperlinked documentation. A normalized d tag serves as the article’s slug; wikilinks "target" resolve to other articles by matching that slug, letting clients always display the latest version. Content follows "Nostr Markdown".
Wiki Article (kind 30818)
An addressable event representing one wiki article. Used for collaborative, hyperlinked documentation or any named page.
Required Tags
| Tag | Description |
|-------|--------------------------------------|
| d | Unique identifier for the article (slug). Normalized: non-letters → -, letters → lowercase. |
Optional Tags
| Tag | Description |
|-----------|-------------|
| title | Display title when it differs from the normalized d value. |
| summary | Short summary for use in lists. |
Content
The content field MUST follow "Nostr Markdown". For wiki articles, wikilinks "target" and "label" resolve to other wiki articles (kind 30818): the client queries for events whose d tag equals the normalized target (after the normalization rules above). Prefer wikilinks for other articles so the client can choose which version to show; use nostr:nevent1… only when a specific version is required.
Event Structure
{
"kind": 30818,
"pubkey": "<author-pubkey>",
"tags": [
["d", "wiki"],
["title", "Wiki"],
["summary", "Lorem ipsum"]
],
"content": "Lorem ipsum",
"created_at": 1700000000
}Client Recommendations
-
Clients SHOULD normalize
dwhen resolving wikilinks: lowercase, replace non-letters with-.
Examples
Basic wiki article
{
"kind": 30818,
"pubkey": "<pubkey>",
"tags": [
["d", "getting-started"],
["title", "Getting Started"]
],
"content": "See link:++/npub1vcxcc7r9racyslkfhrwu9qlznne9v95nmk3m5frd8lfuprdmwzpsxqzqcr/wiki/nostr-markdown++["Nostr Markdown"] for formatting. Use link:++/npub1vcxcc7r9racyslkfhrwu9qlznne9v95nmk3m5frd8lfuprdmwzpsxqzqcr/wiki/getting-started++["this page"] to test wikilinks.",
"created_at": 1700000000
}See Also
-
"Nostr Markdown" — Content format and wikilink syntax
-
"Nostr URI" —
nostr:links in content -
"Task" — Tasks that may reference or attach wiki articles