Hash Tag Extension
This specification is deprecated.
Twtxt files should contain plain hash tags, like
should not be linked to one particular search engine; it is up to the
clients to do this.
The old contents of this specification are only provided for reference.
Users might want to tag their twts with labels to make their contents detectable by other users who are searching for a certain topic. Those labels are called hash tags. They can be used to group several twts on a specific topic. Hash tags enable crossreferencing of twts, e.g. by their most prominent use in the Twt Subject.
Inspired by twtxt mentions, which use the
@<nick url> syntax, hash tags are
in the form of
#<tag url>. Tag and URL are separated by a single space
character. Multiple whitespace characters might be used, but their use is
Both tag and URL are mandatory and must not contain any whitespace. This
extension does not specify a way to escape whitespace in the tag or URL parts.
If the text between
> cannot exactly be split into two parts – tag
and URL – the whole sequence must be treated as regular plain text.
Tags must only contain lower or upper case ASCII letters, numbers, underscores
and minus signs. Other characters are not allowed. A valid tag conforms to the
following regular expression:
The closing angled bracked (
>) cannot be escaped in the URL, other than using
its URL-escaped form
The URL must point to a resource which lists twts for the given tag.
Clients should render the hash symbol (
#) right in front of the tag. Hence,
the name “hash tag”. Given the hash tag
in a twt a terminal client might show it as:
A web UI might generate HTML like:
Clients supporting this extension should provide a way to show the full URL to the users in advance, so that users are able to see, where they would end up when following the URL. This way users can abort and decide against visiting a URL.
Clients may also provide a way to disable hash tag URL folding entirely and always render the URL next to the hash tag in full length.
- 2020-12-16: Initial version.
- 2022-12-21: This specification has been deprecated.