YouTrack Standalone 2022.1 Help

YouTrack Wiki Syntax

Editing Content with YouTrack Wiki Markup

The ability to format text using Markdown was implemented as a replacement for our own markup syntax, YouTrack Wiki. To encourage migration from the deprecated YouTrack Wiki to Markdown, we removed the option to author new content in Wiki syntax. However, we still offer limited support for YouTrack Wiki content.

You may encounter content that was written in YouTrack Wiki in one or more of these contexts:

  • In issues and comments that are created in projects that use the Mailbox integration.

  • In issues that are reported by exception analyzers and other third-party integrations that have not been upgraded to format content in Markdown.

  • Any issue content that was previously authored by users who prefer to use Wiki markup over Markdown syntax.

Special handling has been added to ensure that you can edit content that was written using YouTrack Wiki, when required.

Markup menu with option for YouTrack Wiki.
  • When you edit YouTrack Wiki content, it opens in the old plain-text editor. The plain-text editor lets you switch between YouTrack Wiki and Markdown syntax.

  • If you switch from YouTrack Wiki to Markdown, the content opens in the rich text editor with Markdown mode enabled. The rich text editor lets you switch between Visual and Markdown mode to format the content as needed.

  • When Markdown mode is enabled, you have the option to switch back to YouTrack Wiki.

Hints for commonly-used formatting options are displayed below the input field for editing the issue description and issue comments.

Hints for formatting text with YouTrack Wiki.

To see a complete list of formatting options, click the View markup reference icon next to the markup syntax menu. This opens the YouTrack Markup Reference page in a new browser tab.

Youtrack wiki markup reference

The YouTrack Markup Reference page provides a sandbox. Use the sandbox to preview the formatted output. When the text is formatted to your liking, copy the contents of the sandbox and paste it into the issue description or comment.

Stack Traces

Java stack trace

When the stack trace is formatted, references to source code and other issues are set as links.

If you have installed the YouTrack Integration Plugin, you can click these links to open the target reference in your integrated development environment. This feature is also supported by the TeamCity Integration plugin.

Last modified: 17 May 2022