help: Document pretty message links.

This commit is contained in:
Alya Abbott 2024-11-05 10:04:48 -08:00 committed by Tim Abbott
parent e9e61f303b
commit b9314562a7
3 changed files with 24 additions and 10 deletions

View File

@ -4,7 +4,8 @@
Named link: [Zulip homepage](zulip.com) Named link: [Zulip homepage](zulip.com)
A URL (links automatically): zulip.com A URL (links automatically): zulip.com
Channel link: #**channel name** Channel link: #**channel name**
Channel and topic link: #**channel name>topic name** Topic link: #**channel name>topic name**
Message link: #**channel name>topic name@123**
Custom linkifier: For example, #2468 can automatically link to an issue in your tracker. Custom linkifier: For example, #2468 can automatically link to an issue in your tracker.
``` ```

View File

@ -2,7 +2,6 @@ In Zulip, you can insert a named link using Markdown formatting. In addition, Zu
automatically creates links for you when you enter: automatically creates links for you when you enter:
- A URL - A URL
- An appropriately formatted channel name, or a channel name followed by a topic - A reference to a channel, topic, or specific message (see also [Link to a
(see also [Link to a message or message or conversation](/help/link-to-a-message-or-conversation))
conversation](/help/link-to-a-message-or-conversation))
- Text that matches a [custom linkifier](/help/add-a-custom-linkifier) set up by your organization - Text that matches a [custom linkifier](/help/add-a-custom-linkifier) set up by your organization

View File

@ -50,13 +50,21 @@ This copies to your clipboard a permanent link to the message,
displayed in its thread (i.e. topic view for messages in a channel). displayed in its thread (i.e. topic view for messages in a channel).
Viewing a topic via a message link will never mark messages as read. Viewing a topic via a message link will never mark messages as read.
These links will still work even when the message is These links will still work even when the message is [moved to another
[moved to another topic](/help/move-content-to-another-topic) topic](/help/move-content-to-another-topic) or
or [channel](/help/move-content-to-another-channel) or [channel](/help/move-content-to-another-channel), or if its [topic is
if its [topic is resolved](/help/resolve-a-topic). resolved](/help/resolve-a-topic). Zulip uses the same permanent link syntax when
[quoting a message](/help/quote-and-reply).
Zulip uses the same permanent link syntax when [quoting a When you paste a message link into the compose box, it gets automatically
message](/help/quote-and-reply). formatted to be easy to read:
```
#**channel name>topic name@message ID**
```
When you send your message, the link will appear as **#channel name>topic
name@💬**.
{start_tabs} {start_tabs}
@ -71,6 +79,12 @@ message](/help/quote-and-reply).
If using Zulip in a browser, you can also click on the timestamp If using Zulip in a browser, you can also click on the timestamp
of a message, and copy the URL from your browser's address bar. of a message, and copy the URL from your browser's address bar.
!!! tip ""
When you paste a message link into Zulip, it is automatically
formatted for you. You can paste as plain text if you prefer with
<kbd data-mac-following-key="⌥">Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>V</kbd>.
{end_tabs} {end_tabs}
### Get a link to a specific topic ### Get a link to a specific topic