Mar 27, 2023

Mentioning nostr content

Learn how to mention nostr content in Habla

The recently merged NIP-27 introduces a new way for handling mentions in nostr text content. Instead of using the #[idx] and tags, mentions are now NIP-21 URIs.

Habla implements NIP-27 mentions and will no longer create content with NIP-08 mentions. When editing an article that contains NIP-08 mentions they will be automatically converted to NIP-27.

How do I mention an event?

Add the nostr: prefix to a identifier like

and it'll be interpreted as a mention and rendered inline. The appropriate tags will also be added to the event.

note identifiers also work, but prefer nevent over note identifiers since they include relay information. This makes sure the content can be fetched by clients.

How do I mention a person?

Use a persons npub with a nostr: prefix to mention and show their username inline:

A nprofile identifier includes pubkey and relay information. These will be rendered as a card with the user and relay list:

How do I mention a replaceable event?

Replaceable events have a naddr identifier so you can use the same notation for mentioning them. This will work for articles like naddr1qvzqqqr4gupzpmzzcaj5rzeah8y940ln4z855wa72af4a6aac4zjypql55egcpsqqy88wumn8ghj7mn0wvhxcmmv9uq32amnwvaz7tmjv4kxz7fwv3sk6atn9e5k7tcpr4mhxue69uhh2mnfwejhyum99ehx7um5wf5kx6pwd3skuep0qqfkummnd35j6vfkxuunsv3nx5envvpcxqtzsdzy or other kinds of events like badges

naddr1qvzqqqr48ypzqyzq53qy4gaq3ex4n2shdq2r4r9ujcgjmt5ajfyyrgke5gfqw293qqgkummnw3e97am0wfkxghmgxdax5uq52uzhh

Lists are also replaceable events and can be referenced with an naddr:

naddr1qvzqqqr4xypzqla9dawkjc4trc7dgf88trpsq2uxvhmmpkxua607nc5g6a634sv5qqphq6twjv36ug


Happy writing!