mirror of
https://github.com/zulip/zulip.git
synced 2025-11-03 21:43:21 +00:00
9d2c6a8984
Adds mobile instructions for copying a link to a message, topic, and channel via the long-press action menus. Clarifies some of the text around link formatting being in the web/desktop apps. Fixes some example links to redirect to headers on the page, and adds a missing period to a sentence.
199 lines
5.8 KiB
Markdown
199 lines
5.8 KiB
Markdown
# Link to a message or conversation
|
|
|
|
Zulip makes it easy to share links to messages, topics, and channels. You can
|
|
link from one Zulip [conversation](/help/reading-conversations) to another, or
|
|
share links to Zulip conversations in issue trackers, emails, or other external
|
|
tools.
|
|
|
|
## Link to a channel within Zulip
|
|
|
|
Channel links are automatically formatted as [#channel name](#link-to-a-channel-within-zulip).
|
|
|
|
{start_tabs}
|
|
|
|
{tab|desktop-web}
|
|
|
|
{!start-composing.md!}
|
|
|
|
1. Type `#` followed by a few letters from the channel name.
|
|
|
|
1. Pick the desired channel from the autocomplete.
|
|
|
|
1. Pick the top option from the autocomplete to link to the channel without
|
|
selecting a topic.
|
|
|
|
!!! tip ""
|
|
|
|
To link to the channel you're composing to, type `#>`, and pick the
|
|
top option from the autocomplete.
|
|
|
|
{end_tabs}
|
|
|
|
In the web and desktop apps, when you paste a channel link into Zulip,
|
|
it's automatically formatted as `#**channel name**`. You can use
|
|
<kbd data-mac-following-key="⌥">Ctrl</kbd> + <kbd>Shift</kbd> +
|
|
<kbd>V</kbd> to paste as plain text if you prefer.
|
|
|
|
You can create a channel link manually by typing `#**channel name**`.
|
|
|
|
## Link to a topic within Zulip
|
|
|
|
Topic links are automatically formatted as [#channel > topic](#link-to-a-topic-within-zulip).
|
|
|
|
{start_tabs}
|
|
|
|
{tab|desktop-web}
|
|
|
|
{!start-composing.md!}
|
|
|
|
1. Type `#` followed by a few letters from the channel name.
|
|
|
|
1. Pick the desired channel from the autocomplete.
|
|
|
|
1. Type a few letters from the topic name.
|
|
|
|
1. Pick the desired topic from the autocomplete.
|
|
|
|
!!! tip ""
|
|
|
|
To link to a topic in the channel you're composing to, type `#>`
|
|
followed by a few letters from the topic name, and pick the desired
|
|
topic from the autocomplete.
|
|
|
|
{end_tabs}
|
|
|
|
In the web and desktop apps, when you paste a topic link into Zulip, it's
|
|
automatically formatted as `#**channel name>topic name**`. You can use
|
|
<kbd data-mac-following-key="⌥">Ctrl</kbd> + <kbd>Shift</kbd> +
|
|
<kbd>V</kbd> to paste as plain text if you prefer.
|
|
|
|
You can create a topic link manually by typing `#**channel name>topic name**`.
|
|
|
|
## Link to Zulip from anywhere
|
|
|
|
All URLs in Zulip are designed to be **shareable**, including:
|
|
|
|
- Links to messages, topics, and channels.
|
|
- Search URLs, though note that personal
|
|
[filters](/help/search-for-messages#search-filters) (e.g., `is:followed`) will
|
|
be applied according to the user who's viewing the URL.
|
|
|
|
In addition, links to messages, topics, and channels are **permanent**:
|
|
|
|
- [Message links](#get-a-link-to-a-specific-message) will still work even when
|
|
the message is [moved to another topic](/help/move-content-to-another-topic)
|
|
or [channel](/help/move-content-to-another-channel), or if its [topic is
|
|
resolved](/help/resolve-a-topic). Zulip uses the same permanent link syntax
|
|
when [quoting a message](/help/quote-or-forward-a-message).
|
|
- [Topic links](#get-a-link-to-a-specific-topic) will still work even when the
|
|
topic is [renamed](/help/rename-a-topic), [moved to another
|
|
channel](/help/move-content-to-another-channel), or
|
|
[resolved](/help/resolve-a-topic).
|
|
|
|
!!! tip ""
|
|
|
|
When some messages are [moved out of a
|
|
topic](/help/move-content-to-another-topic) and others are left in place,
|
|
links to that topic will follow the location of the message whose ID is
|
|
encoded in the topic URL (usually the first or last message in the topic).
|
|
|
|
- [Channel links](#get-a-link-to-a-specific-channel) will still work even when a
|
|
channel is [renamed](/help/rename-a-channel) or
|
|
[archived](/help/archive-a-channel).
|
|
|
|
When you copy a Zulip link in the web and desktop apps, and paste it anywhere that
|
|
accepts HTML formatting (e.g., your email, GitHub, docs, etc.), the link will be
|
|
formatted as it would be in Zulip (e.g., [#channel > topic](#link-to-a-topic-within-zulip)).
|
|
To paste the plain URL, you can paste without formatting (likely <kbd>Ctrl</kbd> +
|
|
<kbd>Shift</kbd> + <kbd>V</kbd> in your browser).
|
|
|
|
### Get a link to a specific message
|
|
|
|
This copies to your clipboard a permanent link to the message, displayed in the
|
|
context of its conversation. To preserve your reading status, messages won't be
|
|
automatically marked as read when you view a conversation via a message link.
|
|
|
|
In the web and desktop apps, when you paste a message link into the compose box,
|
|
it gets automatically formatted to be easy to read:
|
|
|
|
```
|
|
#**channel name>topic name@message ID**
|
|
```
|
|
|
|
When you send your message, the link will appear as
|
|
[#channel > topic @ 💬](#get-a-link-to-a-specific-message).
|
|
|
|
{start_tabs}
|
|
|
|
{tab|desktop-web}
|
|
|
|
{!message-actions-menu.md!}
|
|
|
|
1. Click **Copy link to message**.
|
|
|
|
!!! tip ""
|
|
|
|
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.
|
|
|
|
{tab|mobile}
|
|
|
|
{!message-long-press-menu.md!}
|
|
|
|
1. Tap **Copy link to message**.
|
|
|
|
{end_tabs}
|
|
|
|
In the web and desktop apps, when you paste a message link into Zulip,
|
|
it is automatically formatted for you. You can use
|
|
<kbd data-mac-following-key="⌥">Ctrl</kbd> + <kbd>Shift</kbd> +
|
|
<kbd>V</kbd> to paste as plain text if you prefer.
|
|
|
|
### Get a link to a specific topic
|
|
|
|
{start_tabs}
|
|
|
|
{tab|desktop-web}
|
|
|
|
{!topic-actions.md!}
|
|
|
|
1. Click **Copy link to topic**.
|
|
|
|
!!! tip ""
|
|
|
|
If using Zulip in a browser, you can also click on a topic name,
|
|
and copy the URL from your browser's address bar.
|
|
|
|
{tab|mobile}
|
|
|
|
{!topic-long-press-menu.md!}
|
|
|
|
1. Tap **Copy link to topic**.
|
|
|
|
{end_tabs}
|
|
|
|
### Get a link to a specific channel
|
|
|
|
{start_tabs}
|
|
|
|
{tab|desktop-web}
|
|
|
|
{!channel-actions.md!}
|
|
|
|
1. Click **Copy link to channel**.
|
|
|
|
{tab|mobile}
|
|
|
|
{!channel-long-press-menu.md!}
|
|
|
|
1. Tap **Copy link to channel**.
|
|
|
|
{end_tabs}
|
|
|
|
## Related articles
|
|
|
|
* [Add a custom linkifier](/help/add-a-custom-linkifier)
|
|
* [Message formatting](/help/format-your-message-using-markdown)
|
|
* [Linking to your organization](/help/linking-to-zulip)
|
|
* [Pin information](/help/pin-information)
|