YouTrack supports an extension to the syntax for images that lets you embed content from Google apps into an issue. Supported apps include Docs, Sheets, Slides, and Forms. You can embed content into any field that supports Markdown, including the issue description, supplementary text fields, comments, or work items.
This feature is subject to the following restrictions:
- The content must be published to the web. This makes the content visible to anyone over the internet.
- In the settings for published content, the option to require viewers to sign in with their G Suite accounts must be disabled. If you restrict access to the published file, the content is not visible when embedded into an issue.
- The publication settings in Google apps include an option to automatically republish the content when changes are made. When this option is enabled, updates to the published document are only shown in the issue when you refresh the page.
- Similar to the previous point, changes that are applied to the published content are not tracked in the issue history.
- The frame into which the content is embedded has a fixed height. For longer files, you need to scroll to view all of the content.
- The embedded content does not include a link to open the file in the app. If you want give other users access to the file, you need to paste the link into the issue separately.
- The content in the embedded file is not indexed for text search in YouTrack.
To embed published content from a Google app:
- Start the line with an exclamation point (!).
- Wrap the alt text with brackets ([ ]).
- Set the URL for the file in parentheses (( )). Use the URL that is shown as the Link to the document, not the HTML that is shown for the Embed option.