diff --git a/help/animated-gifs-from-giphy.md b/help/animated-gifs-from-giphy.md index d81792b991..86d61e2b08 100644 --- a/help/animated-gifs-from-giphy.md +++ b/help/animated-gifs-from-giphy.md @@ -67,3 +67,6 @@ recipients of GIFs from GIPHY. [configure-giphy]: https://zulip.readthedocs.io/en/stable/production/giphy-gif-integration.html +## Related articles + +* [Share and upload files](/help/share-and-upload-files) diff --git a/help/share-and-upload-files.md b/help/share-and-upload-files.md index 1433b48755..8675a5c5f9 100644 --- a/help/share-and-upload-files.md +++ b/help/share-and-upload-files.md @@ -1,21 +1,58 @@ # Share and upload files -Attach files to messages, including images, documents, sound, and video. +Zulip supports attaching multiple files to messages, including images, +documents, sound, and video. You can edit the names of the files others see +after you upload them. -First, [open the compose box](/help/open-the-compose-box). Then +Zulip will automatically generate a **thumbnail** for each file when you send +the message, if it can. Image thumbnails will be shown directly in the message, +and you can click on a thumbnail to [view the full image](/help/view-and-browse-images). -* **Drag and drop** files into the compose box. -* **Copy and paste** files into the compose box. -* Click the **paperclip** () icon at - the bottom of the compose box to find files on your computer. +## Uploading files -Zulip will insert a link to the file, in Markdown format: -`[link text](URL)`. You can modify the `link text` to whatever you want. +{start_tabs} -Zulip will automatically generate a **thumbnail** of the file when you send -it, if it can. You can -[preview the message](/help/preview-your-message-before-sending) before -sending to see what the thumbnail will look like. +{tab|via-markdown} + +{!start-composing.md!} + +1. Drag and drop files, or copy and paste one or more files into the compose + box. Zulip will upload the files, and insert named links using + [Markdown formatting](/help/format-your-message-using-markdown#links): + `[Link text](URL)`. + +1. _(optional)_ Modify the link text as desired. + +{tab|via-compose-box-buttons} + +{!start-composing.md!} + +1. Click the **paperclip** () icon at + the bottom of the compose box to select one or more files. Zulip will upload + the files, and insert named links using + [Markdown formatting](/help/format-your-message-using-markdown#links): + `[Link text](URL)`. + +1. _(optional)_ Modify the link text as desired. + +{end_tabs} + +!!! tip "" + + You can [preview the message](/help/preview-your-message-before-sending) + before sending to see what your uploaded files will look like. + +## Named file example + +### What you type + +``` +[A whale of a good time](https://your.zulip.domain/user_uploads/1/46/IPvysqXEtiTG1ZdNBrwAZODi/whale-time.png) +``` + +### What it looks like + +![Markdown image](/static/images/help/markdown-image.png) ## Troubleshooting info @@ -29,3 +66,4 @@ This limit can be changed by the server administrator. * [Manage your uploaded files](/help/manage-your-uploaded-files) * [View and browse images](/help/view-and-browse-images) +* [Animated GIFs](/help/animated-gifs-from-giphy) diff --git a/static/images/help/markdown-image.png b/static/images/help/markdown-image.png new file mode 100644 index 0000000000..36983a16fb Binary files /dev/null and b/static/images/help/markdown-image.png differ