Markdown の構文
YouTrack では、Markdown マークアップ構文を使用してテキストをフォーマットできます。課題の説明、補足テキストフィールド、コメント、作業項目の説明のテキストをフォーマットできます。このタイプのマークアップは、リッチテキストエディターのビジュアルフォーマットツールの代わりに提供されます。テキストのフォーマットに使用できるオプションの詳細については、リッチテキストエディターを参照してください。
YouTrack の Markdown 実装は、拡張機能付きの CommonMark の仕様(英語)に従います。これらの拡張機能は、チェックリスト、取り消し線付きのテキスト、表、ユーザーのメンション、課題のリンクなど、正式な仕様に含まれていないフォーマットオプションをサポートしています。
フォーマットオプションの完全なリストを表示するには、Markdown リンクをクリックして構文リストを開き、 ヘルプアイコンをクリックします。これにより、ブラウザーで YouTrack マークアップのリファレンスページが開きます。

YouTrack マークアップのリファレンスページにサンドボックスがあります。サンドボックスを使用してフォーマットされた出力をプレビューします。テキストが好みに合わせてフォーマットされたら、サンドボックスの内容をコピーして課題の説明またはコメントに貼り付けます。
使用可能
YouTrack は、課題フィールドに加えて、プロジェクトの説明、マークダウンノートウィジェット、ユーザー契約、システム全体のバナー、ログインページのカスタムメッセージで Markdown をサポートします。ここで説明する拡張機能の多くは、これらのフィールドでは使用できません。例: Google アプリからの埋め込みコンテンツ、埋め込みビデオ、YouTube ビデオ、課題のリンク、記事のリンク、ユーザーのメンションをサポートする拡張機能は、課題と記事でのみサポートされます。HTML タグを解析する機能は、号と記事のみに限定されます。
これらのフィールドに入力したコンテンツが正しくフォーマットされていることを確認するには、入力フィールドの左側にあるプレビューペインを使用してください。

文字書式設定
次の Markdown 構文を使用して、さまざまなインラインテキストに文字書式を適用できます。
スタイル | 構文 |
---|---|
ストロング | 2 つのアスタリスク( |
強調 | 単一のアスタリスク( |
取り消し線 | テキストを 2 つのチルダで囲む( |
コード | インラインコードスパンをフォーマットするには、1 つ以上の逆引用符でテキストを囲みます( |
組み合わせ | 2 つのアスタリスクの中に 1 つの下線文字または 2 つのチルダを使用してテキストを囲みます。強い強調を適用するために 3 つのアスタリスクでテキストを囲みます。 |
見出し
見出しは、テキストをさまざまなセクションに整理できます。見出しは、太字のフォントサイズを大きくすることで、テキストの残りの部分と区別されます。
見出しスタイルを適用するには、1 〜 6 つの番号記号(#
)で行を始めます。番号記号の後にスペース文字を続けて、見出しテキストを入力します。#
サインの数は、見出しレベルを決定します。
YouTrack は見出しレベル 1 と 2 の代替構文もサポートします。
見出しレベル 1 の場合、次の行に 1 つ以上の
=
文字を入力します。見出しレベル 2 の場合は、次の行に 1 つ以上の
-
文字を入力します。
段落と改行
テキストの連続行は同じ段落に属します。次のガイドラインに従って、コンテンツを段落に分割して改行を入力してください。
新しい段落を始めるには、テキスト行の間に空白行を入れます。
段落内で新しい行を開始するには、テキスト行の末尾に 2 つ以上の末尾スペースを入力します。より見やすい方法として、単一のバックスラッシュ(
\
)を入力してください。
テーマ別休憩
テーマ別の区切りでコンテンツにセクションを作成します。テーマ別の休憩を追加するには、次のいずれかの方法を使用します。
3 つ以上のアンダースコア (
___
)3 つ以上のマイナス記号 (
---
)3 つ以上のアスタリスク (
***
)
サブジェクトの区切りによって段落が中断されたり、空白文字が含まれたりする可能性があることに注意してください。インデントには 3 つを超えるスペースを使用することはできず、同じ非空白文字を使用する必要があります。
ブロック引用符
別の情報源からの引用に特別な注意を払うには、ブロック引用符を使用します。引用符付きブロック内のインラインテキストに文字書式を適用できます。
テキストを引用ブロックとして設定するには、1 行以上の >
文字で行を始めます。これらの文字の後にスペースを入れて、引用符で囲まれたテキストを入力してください。>
符号の数は、引用ブロック内のネストレベルを決定します。
引用符が複数の段落にまたがる場合は、各空白行を >
文字で始める必要があります。これにより、引用ブロック全体が確実にグループ化されます。
インデントコードブロック
テキストのブロックを等幅フォントでフォーマットして、コードとして識別して読みやすくすることができます。
Markdown でコードブロックをフォーマットするには、ブロックのすべての行を少なくとも 4 つのスペースでインデントします。インデントされたコードブロックは段落を中断できないため、段落とそれに続くインデントされたコードブロックの間に少なくとも 1 行の空行を挿入する必要があります。入力は次のように処理されます。
コードブロックの各行から 1 レベルのインデント(4 つのスペース)が削除されます。
コードブロックの内容はリテラルテキストであり、Markdown として解析されません。
先頭スペースが 4 つ未満の空白でない行はコードブロックを終了し、新しい段落を開始します。
囲まれたコードブロック
インデントされたコードブロックとは異なり、フェンスで囲まれたコードブロックには、構文のハイライトに使用する言語を指定できる情報文字列があります。言語固有のハイライトにより、コードが読みやすくなります。
構文のハイライトは、さまざまな言語でサポートされています。YouTrack は、C、C++、C#、Java、JavaScript、Perl、Python、Ruby、SH のコードを自動的に検出してハイライトします。他の言語のコードをハイライトするには、情報文字列(開始コードフェンスのある行)で言語を設定します。次の言語がサポートされています: apollo(AGC/AEA Assembly Language)、basic、clj(Clojure)、css、dart、erlang、hs(Haskell)、kt(Kotlin)、latex(LaTeX)、lisp、llvm、lua、matlab、ml、mumps、n(Nemerle)、pascal、proto、scala、sql、tcl、tex、vb、vhdl、wiki、xq、yaml。
情報文字列で言語を設定すると、コードの上の行に言語タグが表示されます。

YouTrack は、GitHub の Markdown 実装によって解釈される言語エイリアスのセットを認識します。これには、次の言語エイリアスが含まれます。
言語エイリアス | 言語名 | YouTrack による構文ハイライトの適用 |
---|---|---|
fsharp | F# | fs |
kts | Kotlin スクリプト | kt |
オクターブ | マトラブ | マトラブ |
ラテックス | ラテックス | テックス |
vb.net または vbnet | Visual Basic .NET | vb |
yml | YAML | ヤムル |
テキストのブロックを構文のハイライト付きのコードのブロックとして設定するには、次のガイドラインに従います。
複数行にわたるコードで囲まれたコードブロックを作成するには、テキストを 3 つ以上の逆引用符(
```
)またはチルダ(~~~
)の内側に設定します。同じ文字でブロックを開閉します。
コードフェンスの開閉には同じ文字数を使用してください。
フェンスで囲まれたコードブロックを開くために使用する文字のセットと同じ行の直後に、構文のハイライトに使用する言語または言語エイリアスを指定します。
スタックトレース
囲い込まれたコードブロックはスタックトレースとしてフォーマットできます。コードをスタックトレースとしてフォーマットするには:
ちょうど 3 つの逆引用符(
```
)またはチルダ(~~~
)で囲われたコードブロックを開閉します。コードブロックを開くのに使用した同じ文字でコードブロックを閉じます。言語を設定するには、コードフェンスの最初の行に
stacktrace
と入力します。スタックトレースを fenced コードブロックに貼り付けます。
スタックトレースがフォーマットされると、ソースコードへの参照やその他の課題がリンクとして設定されます。開発環境でこの機能が有効になっている場合は、これらのリンクをクリックして IDE でターゲット参照を開くことができます。詳しくは、IDE でスタックトレースを開くを参照してください。
HTML ブロック
HTML ブロックは、生の HTML マークアップとして扱われる行のグループです。ブロックは、YouTrack が有効な HTML タグを検出した場所から始まり、一致する終了タグが存在する行で終了します。開始タグと終了タグ間のコンテンツは、エスケープせずに HTML でレンダリングされます。
有効な HTML コンテンツが記述どおりに表示されない場合があります。
すべてのマークアップは、許可されたタグの事前定義リストと照合されます。攻撃者によって悪用される可能性のあるタグおよび属性内のコンテンツは除外されます。
HTML ブロックを開始するタグの前に 3 つを超えるスペース文字を含めることはできません。4 つ以上のスペースで始まるブロックは、インデントされたコードとしてフォーマットされます。
HTML マークアップでは、次の機能を使用して課題のコンテンツを強化できます。
フィーチャー | 説明 |
---|---|
折りたたみ可能なブロック | |
カスタムテキストの色 | |
改行 | |
イージーモードのブロック引用 | Markdown のブロック引用符のネイティブ構文で同じ結果を得るには、空の各行に |
インラインテキストも HTML マークアップ用に解析されます。左山括弧括弧(<)と終了山括弧括弧(>>)の間に設定されたテキストは、許可タグの事前定義リストと照合されます。YouTrack が安全であると判断した場合、タグは HTML として解析されます。タグ内のコンテンツは、エスケープせずに HTML でレンダリングされます。
HTML としてレンダリングされる課題にコンテンツを貼り付けていて、テキストを記述どおりに表示したい場合は、マークアップをエスケープする必要があります。方法については、HTML のエスケープを参照してください。
リスト
リストを作成するには、次の構文を使用します。
番号なしリストを作成するには、マイナス記号(
-
)、アスタリスク(*
)、プラス記号(+
)で行を始めます。番号付きリストを作成するには、番号の後にピリオド(
1.
)または右括弧(1)
)を付けて行を始めます。番号付きリストの開始番号は、その初期リスト項目の番号によって決まります。後続のリスト項目の数は無視されます。番号なしリストを番号なしリストまたは番号付きリストの中にネストするには、行を 2 つのスペースでインデントします。順序付きリストのネストはサポートされていません。
チェックリスト
チェックリストは CommonMark の仕様(英語)ではサポートされていません。この機能は拡張機能で実装されています。GitHub Flavored Markdown のタスクリストの項目 (拡張)(英語) と似ていますが、YouTrack での実装は若干異なります。
チェックリストを作成するには、次の構文を使用します。
順不同リストと同じようにチェックリストを開始します。行の先頭にマイナス記号(-)、アスタリスク(*)、プラス記号(+)を入力します。これはリストアイテムマーカーとして解釈されます。
リスト項目マーカーの後に 1 つ以上のスペース、左括弧 ([), either a whitespace character or the lowercase letter x, and then a right bracket (]) が続きます。これはチェックリスト項目マーカーとして解釈されます。
括弧の間の文字が空白文字の場合、チェックボックスはオフになっています。
括弧の間の文字が小文字の x である場合、チェックボックスはチェックされています。
チェックリスト項目マーカーの後に任意のテキスト文字列を入力します。テキストはチェックボックスとインラインで表示されます。
テーブル
テーブルは、コンテンツに構造を追加するための優れたツールです。テーブルを作成するには、次の構文を使用します。
列を作成するには、縦棒(
|
)を使用します。外側のバーはオプションです。ヘッダー行を 3 つ以上のマイナス記号(
---
)でテーブルの残りの部分から区切ります。列テキストを右寄せにするには、区切り行のマイナス記号の右側にコロン(
:
)を追加します。テキストを列の中央に配置するには、マイナス記号の両側にコロン(
:
)を追加します。列のテキストを左揃えにするには、区切り行のマイナス記号の左側にコロン(
:
)を追加します。
生の Markdown では列が完全に並んでいる必要はないことに注意してください。テーブル内のテキストに文字書式を追加することもできます。
リンク
Markdown を使ってリンクを挿入する方法はいくつかあります。
スタイル | フォーマット |
---|---|
インライン化 | リンクテキストを括弧 |
ツールチップとインライン | インラインフォーマットを使用し、URL の後に引用符でツールチップを追加します。 |
リファレンス | URL を括弧 |
YouTrack は、自動リンクを含むように標準構文も拡張しました。
自動リンク
自動リンクは、山括弧括弧(< >
)内に設定される絶対 URI とメールアドレスです。これらはリンクとして解析され、URL またはメールアドレスがリンクラベルとして使用されます。異なり、リンクリンクテキストとツールチップを指定することができ、この構文は、単純にクリック可能なリンクに URL やメールアドレスを変換します。
YouTrack は URL の拡張構文をサポートしています。URL として解析された文字列は、山括弧括弧がなくてもクリック可能なリンクに変換されます。山括弧括弧内に設定されていないメールアドレスはテキストとして表示されます。
課題リンク
既存の issue ID と一致する一連の文字が自動的に解析され、対応する issue へのリンクに変換されます。
ナレッジベースの記事へのリンク
既存の記事 ID と一致する文字のシーケンスは自動的に解析され、ナレッジベースの対応する記事へのリンクに変換されます。ユーザーがリンクの上にポインターを移動すると、カスタムツールチップに、タイトル、作成者、作成日など、記事に関する追加情報が表示されます。

ユーザーのメンション
ユーザーのメンションもリンクとして設定されます。@
を入力すると、YouTrack は、ユーザー名が次の入力に一致するユーザーを提案します。選択したユーザーを完成させるか、有効なユーザー名を入力すると、@mention がユーザーの氏名に置き換えられ、リンクとして設定されます。
イメージ
イメージの構文はリンクの構文と似ています。インラインイメージを挿入するには:
感嘆符(
!
)で行を始めてください。代替テキストを括弧(
[ ]
)で囲みます。イメージの URL とツールチップを括弧内に設定します(
( )
)。
イメージに参照スタイルを使用することもできます。イメージ参照を挿入するには:
感嘆符(
!
)で行を始めてください。代替テキストを括弧(
[ ]
)で囲みます。イメージ参照を括弧(
[ ]
)に設定してください。構文
[tag]: image URL "tooltip"
を使用して、イメージ参照を別の場所に定義します。
イメージ属性
イメージのカスタム height
および width
寸法を設定できます。これらの属性は、YouTube 動画、埋め込み動画、Google アプリの埋め込みコンテンツでも利用できます。
次のガイドラインを使用して、カスタム表示サイズを設定します。
波括弧(
{ }
)でサイズ属性をラップし、コンテンツ参照の後に置きます。height
またはwidth
属性のいずれかを指定して、元のアスペクト比を維持しながらイメージを均等にスケーリングします。両方の属性を使用して、目的のディメンションを明示的に設定します。属性の値を整数として指定し、絶対サイズをピクセル単位で設定します。例:
width=250
は 250px として解析されます。width
属性をパーセンテージで指定して、表示領域に対するサイズを決定します。例:width=25%
は、元の縦横比を維持しながら、表示領域の 25% を占めるようにイメージのサイズを変更します。この機能は、
width
属性でのみサポートされています。パーセンテージとしてのheight
属性への参照は無視されます。
画像の添付ファイル
issue にすでに添付されているイメージへのインライン参照を挿入できます。イメージは、参照が配置されている説明、コメント、作業項目に表示されます。
イメージに使用されているのと同じ構文を使用して、イメージの URL を添付ファイルのファイル名に置き換えます。
感嘆符(
!
)で行を始めてください。代替テキストを括弧(
[ ]
)で囲みます。ファイル名とオプションのツールチップを括弧内に設定します(
( )
)。
添付ファイル
イメージに加えて、課題に添付されているファイルへのリンクを追加できます。イメージファイルまたは PDF を参照するリンクは、ブラウザーでファイルを直接開きます。他のすべてのファイルタイプの場合、リンクにより、ユーザーはファイルのコピーをローカルマシンにダウンロードできます。
ファイルにリンクを追加するための構文は、URL にリンクを追加するための形式に似ています。
スタイル | フォーマット |
---|---|
インライン化 | リンクテキストを括弧 |
ツールチップとインライン | インライン書式を使用して、ファイル名の後に引用符でツールチップを追加します。 |
リファレンス | URL を、括弧 |
埋め込み動画
イメージの添付ファイルの構文を使用して、issue に添付されているビデオファイルを埋め込むことができます。ビデオプレーヤーは周囲のテキストとインラインで表示されます。埋め込みプレーヤーで直接ビデオを再生できます。
感嘆符(
!
)で行を始めてください。代替テキストを括弧(
[ ]
)で囲みます。ファイル名を括弧内に設定します(
( )
)。
この機能は、MPEG-4、Ogg、WebM 形式のファイルにのみ使用できます。
Mermaid ダイアグラム
Mermaid ダイアグラムは、フローチャート、シーケンスダイアグラム、ガントチャート、その他のデータやプロセスの視覚的表現を生成するために使用されるダイアグラム表作成言語およびツールの一種です。シンプルなマークダウンのような構文を使用して Mermaid ダイアグラムを作成できるため、簡単に記述して理解できます。
Mermaid ダイアグラムのコードがすでにある場合は、リッチテキストエディターに直接貼り付けることができます。
既存の Mermaid ダイアグラムを Markdown モードのリッチテキストエディターにコピーするには:
リッチテキストエディターで直接 Mermaid ダイアグラムを作成するには、フェンスコードブロックを開始し、プログラミング言語として mermaid を指定します。フェンスブロック内にダイアグラムのコードを記述します。入力すると、ダイアグラムがプレビューペインに表示されます。
LaTeX 数学表記
LaTeX でフォーマットされた数式があり、それを課題や記事で表示する必要がある場合は、それをフェンスで囲まれたコードブロックに入れて、そこで latex
言語を指定できます。YouTrack は LaTeX マークアップを認識し、数式をレンダリングします。
YouTrack の実装は、align
、equation
、gather
、array
、matrix
を含む、さまざまなタイプの数学表記と構造のほとんどの環境をサポートします。また、表示数学モードを示すために二重ドル記号 ($$
) を使用する古い表記法もサポートしています。表示数学モードでは、方程式、数式、数式がページの中央の別の行に表示されます。
YouTrack クラシックで課題を編集すると、レンダリングされた数式がプレビューに表示されます。変更を保存すると、課題はレンダリングされた出力を表示します。

YouTrack Lite で記事または課題を編集すると、ビジュアルモードでレンダリングされた数式のプレビューを表示できます。
YouTrack は、LaTeX 式を処理するために KaTeX(英語) ライブラリを使用します。サポートされているシンボルと関数の完全なリストについては、ライブラリリファレンス(英語)を参照してください。
バックスラッシュのエスケープ
書かれたとおりに表示したい Markdown として解析された文字がある場合は、円記号(\
)を使用してその文字をエスケープすることができます。
マークアップされていない文字の前のバックスラッシュはバックスラッシュ文字として表示されます。
エスケープ文字は通常の文字として扱われます。Markdown 構文におけるそれらの通常の意味は無視されます。
バックスラッシュエスケープは、分離コードブロック、インラインコードスパン、自動リンクでは機能しません。
HTML のエスケープ
コードを課題に貼り付けており、HTML としてレンダリングしたくない場合は、次のいずれかの方法を使用してマークアップをエスケープします。
スペースを作る — 4 つ以上のスペースでインデントされたテキストの行は、Markdown ではインデントされたコードブロックとして自動的にフォーマットされます。
囲い込む — コードを 3 つ以上の逆引用符 (
```
) またはチルダ (~~~
) で囲み、「コードフェンス」を形成します。フェンスで囲まれたコードブロックでは、言語 (html
など) を指定して構文のハイライトを有効にすることもできます。切り戻す — 書かれたとおりに表示したい文字があるときはいつでも、円記号(
\
)で文字をエスケープします。
関連ページ:

リッチテキストエディター
フォーマットにより、書き言葉の明瞭さと表現が向上します。YouTrack は、リッチテキストエディターでテキストをフォーマットするための 2 つのモード、ビジュアルと Markdown を提供します。YouTrack は、課題、記事の編集、コメントの投稿時に最後に使用したモードを記憶しています。あるモードを他のモードよりも優先する場合は、切り替える必要はありません。リッチテキストエディターは、課題の説明、フォーマットされたテキストフィールド、コメント、作業項目の説明、ナレッジベース内の記事とそのコメ...

プロジェクトを構成する
プロジェクトを作成すると、YouTrack はプロジェクト概要ページを開きます。このページは、プロジェクトリストからプロジェクトを選択したときにも表示されます。プロジェクト概要ページから、プロジェクト管理ページにすばやくアクセスできます。プロジェクトチーム:プロジェクトが作成されると、プロジェクトチームが自動的に作成されます。プロジェクトを作成したユーザーは自動的にチームに追加されます。プロジェクトチームに追加されたユーザーとグループには、プロジェクト内のコントリビューターロールが付与されます...

クイックノートウィジェット
クイックノートウィジェットは、ダッシュボードに表示したいメッセージを表示します。このウィジェットを使用すると、Markdown 構文を使用してテキストをフォーマットできます。この機能は、ダッシュボードを他のユーザーと共有している場合に特に便利です。このウィジェットは、チームにとって重要な更新を投稿するためのボードとして使用できます。ダッシュボードにクイックノートウィジェットを追加するには: メインナビゲーションメニューでダッシュボードをクリックします。ウィジェットのダッシュボードを選択します。ダッ...

ユーザー使用許諾契約
YouTrack のユーザー使用許諾契約ページで、YouTrack にログインするユーザーに提示されるユーザー契約を保存できます。これにより、一連の契約条件やプライバシーポリシーなどの情報通知の個々の受け入れを収集および追跡できます。この機能を使用して、EU 加盟国で事業を行う企業の一般データ保護規則(GDPR)要件で概説されている YouTrack に保存されている個人データを処理するポリシーをユーザーに通知します。利用規約テキストのフォーマット:YouTrack では、Markdown を...

システム全体のバナーを表示する
システム内のすべてのユーザーに表示する通知を含む情報バナーを YouTrack に追加できます。例: システムメンテナンスの予定されたダウンタイムについてユーザーに警告できます。有効にすると、YouTrack の各ページの上部にバナーが表示されます。バナーは、ゲストを含め、YouTrack インストールを使用するすべてのユーザーに表示されます。バナー自体は次のように動作します。バナーは静的です。ユーザーはそれを閉じることも閉じることもできません。この機能が有効になっているときに YouTrack...

認証モジュールの共通設定
共通設定ページには、YouTrack のすべての認証モジュールに適用される構成オプションが表示されます。このページにアクセスするには、管理メニューのアクセス管理セクションから Auth モジュールを選択し、ツールバーの共通設定リンクをクリックします。一般設定:一般タブには次の設定が表示されます。トークンのタイムアウトアクセストークンの最大有効期間を指定します。この値を小さくすると、アクセストークンを取得した悪意のあるユーザーがアプリケーションにアクセスできる時間を制限できます。デフォルトは 1...