diff --git a/help/link-to-a-message-or-conversation.md b/help/link-to-a-message-or-conversation.md index 6c6ca7a1df..ad61319684 100644 --- a/help/link-to-a-message-or-conversation.md +++ b/help/link-to-a-message-or-conversation.md @@ -5,39 +5,56 @@ 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 or topic within Zulip +## Link to a channel within Zulip -Zulip automatically creates links to channels and topics in messages you send. - -The easiest way to link to a channel or topic is: +Channel links are automatically formatted as [#channel name](). {start_tabs} -1. Type `#` followed by the one or more letters of the channel name. +{!start-composing.md!} -1. Choose the desired channel from the auto-complete menu. The link will be - automatically formatted for you. +1. Type `#` followed by a few letters from the channel name. -1. If linking to a topic, type `>` after selecting a channel as - described above, followed by one or more letters of the topic name. +1. Pick the desired channel from the autocomplete. -1. Choose the desired topic from the auto-complete menu. The link will be - automatically formatted for you. +1. Pick the top option from the autocomplete to link to the channel without + selecting a topic. !!! tip "" - When you paste a topic or channel link into Zulip, it is automatically - formatted for you. You can paste as plain text if you prefer with - Ctrl + Shift + V. + You can create a channel link manually by typing `#**channel name**`. {end_tabs} -Alternatively, it is possible to manually format channel and topic links: +When you paste a channel link into Zulip, it's automatically formatted as +`#**channel name**`. You can paste as plain text if you prefer with Ctrl + Shift + V. -``` -Channel: #**channel name** -Topic: #**channel name>topic name** -``` +## Link to a topic within Zulip + +Topic links are automatically formatted as [#channel > topic](). + +{start_tabs} + +{!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 "" + + You can create a topic link manually by typing `#**channel name>topic name**`. + +{end_tabs} + +When you paste a topic link into Zulip, it's automatically formatted as +`#**channel name>topic name**`. You can paste as plain text if you prefer with +Ctrl + Shift + V. ## Link to Zulip from anywhere diff --git a/help/mention-a-user-or-group.md b/help/mention-a-user-or-group.md index 431ffbdc8e..d093a48590 100644 --- a/help/mention-a-user-or-group.md +++ b/help/mention-a-user-or-group.md @@ -10,9 +10,9 @@ {!start-composing.md!} -2. Type `@` followed by a few letters from a name or email address. +1. Type `@` followed by a few letters from a name or email address. -3. Pick the appropriate user or user group from the autocomplete. +1. Pick the appropriate user or user group from the autocomplete. {end_tabs} diff --git a/templates/corporate/case-studies/asciidoctor-case-study.md b/templates/corporate/case-studies/asciidoctor-case-study.md index 91453599a8..53334b5cb5 100644 --- a/templates/corporate/case-studies/asciidoctor-case-study.md +++ b/templates/corporate/case-studies/asciidoctor-case-study.md @@ -94,7 +94,7 @@ the wrong channel or topic, Zulip allows me to [move those messages around](/help/move-content-to-another-channel) so they land in the right spot,” Dan says. “Moving messages also sends a subtle hint to the person posting about where to post the next time. And I can use [topic -references](/help/link-to-a-message-or-conversation#link-to-a-channel-or-topic-within-zulip) +references](/help/link-to-a-message-or-conversation#link-to-a-topic-within-zulip) to link to the new topic location, or to a related topic. That’s incredibly powerful,” Dan says.