Markdown
Markdown (英語) は、フォーマット要素をプレーンテキストに追加するための軽量のマークアップ言語です。 DataGrip は Markdown ファイルを認識し、ハイライト、補完、フォーマットを備えた専用エディターを提供します。 サポートは CommonMark 仕様 に基づいています。
Markdown プラグインをインストールする
この機能は、インストールして有効にする必要がある Markdown(英語) プラグインに依存しています。
Ctrl+Alt+S を押して設定を開き、 を選択します。
Markdown プラグインを探して、 インストール をクリックします。 プロンプトが表示されたら IDE を再起動します。
新しい Markdown ファイルを作成する
デフォルトでは、DataGrip は、 .md または .markdown 拡張子を持つすべてのファイルを Markdown ファイルとして認識します。
ファイル ツールウィンドウ（Alt+2 ）でディレクトリを右クリックし、 を選択します。
または、必要なディレクトリを選択し、 Alt+Insert を押してから、 ファイル を選択することもできます。
認識された拡張子を持つファイルの名前を入力します（例: readme.md ）。
Markdown エディターは、テキストフラグメントを選択したときに表示される フローティングツールバーにいくつかの基本的なフォーマットアクションを提供します。 プレビューペインを使用して、レンダリングされた HTML を表示できます。
また、現在の プロジェクト またはアタッチディレクトリ内のファイルへのリンク用に 補完 も利用できます。ソースコード、画像、または他の Markdown ファイルを参照する場合に便利です。 詳細については、 リンク を参照してください。
Markdown のフォーマット
フローティングツールバー
Markdown ファイルでテキストを選択すると、DataGrip はさまざまなフォーマットオプションを備えたフローティングツールバーを表示します。
通常のテキストや H1 から H6 までのレベルのヘッダーを切り替えます。
太字 Ctrl+B
斜体 Ctrl+I
取り消し線 Ctrl+Shift+S
コード Ctrl+Shift+C
リンク作成 Ctrl+Shift+U
箇条書きリスト
番号付きリスト
チェックリスト
フローティングツールバーをカスタマイズする
Ctrl+Alt+S を押して設定を開き、 を選択します。
Markdown エディターのフローティングツールバー で必要なアクションを追加または削除します。
詳細については、 メニューおよびツールバー を参照してください。
変更を適用するには、 OK をクリックします。
フローティングツールバーを非表示にする
Ctrl+Alt+S を押して設定を開き、 を選択します。
Markdown で フローティングツールバーの非表示 を選択します。
変更を適用するには、 OK をクリックします。
リンク
次の構文でリンクを定義できます：
リンクを挿入
Alt+Insert を押して 生成する ポップアップを開き、 リンク作成 を選択します。
一部のテキストがハイライトされている場合は、リンクのテキストとして [ ] で囲まれます。 URL をクリップボードにコピーした場合は、リンク URL として ( ) で囲まれます。
リンクにカーソルを合わせると、オプションのタイトルが表示されます。
他のファイルやヘッダーへのリンク
URL の他に、現在のファイルの任意のヘッダーへのリンクも追加できます：
# This is a chapter Link to [this chapter](#this-is-a-chapter)現在のファイルに関連する他のファイルへもリンクできます：
# This is a chapter Link to [a chapter in another file](another-file.md#some-chapter)
DataGrip は、現在のコンテキストで利用できるリンクラベル：現在のファイルに関連するファイルおよび有効なヘッダーラベルの補完を提供します。
参照されるヘッダーに移動するためのリンクラベルの Ctrl+Click。
ヘッダーまたはラベルで 使用箇所の検索 Alt+F7 を呼び出すと、このラベルを指すすべてのリンクを表示できます。 ヘッダーまたはラベルで 名前の変更 リファクタリング Shift+F6 を呼び出して、関連するすべての使用箇所とともに名前を変更することもできます。
イメージ
デフォルトで、Markdown は画像に次の構文を使用します。これは、プロジェクト またはアタッチディレクトリ内のパス補完を利用して自分で入力できます：
画像の挿入
Alt+Insert を押して 生成する ポップアップを開き、 画像を挿入 を選択します。
画像を挿入 ダイアログで画像へのパスを指定し、 OK をクリックします。
イメージを設定するには、イメージが挿入されている行のガターで 
をクリックします。 例: 画像を挿入 および 画像の構成 ダイアログで HTML に変換 を選択して、生の HTML マークアップを含むイメージを Markdown ファイルに挿入できます。
これにより、次のようになります：
リスト
Markdown は、順序なしリスト用に -、 *,、 + に続けてスペースを入力する形式と、順序付きリスト用に数字に続けてピリオド (1.、 2.、 3.) を入力する形式をサポートしています。 チェックボックス付きのタスクリストには、 - [x] を使用できます。 簡単にフォーマットするには、 フローティングツールバー を使用します。
IDE は入力中にリスト内のインデントを自動的に調整し、階層に合わせます。 この動作は設定で無効にできます: Ctrl+Alt+S を押して設定を開き、 を選択して、 入力時にインデントを調整 を無効にします。
リストの番号付けを設定する
DataGrip で順序付きリストの番号付け方法を制御できます。
Ctrl+Alt+S を押して設定を開き、 を選択します。
リスト セクションで、 入力時にリスト番号を再割り当てする。 を有効にします。
DataGrip は入力中に順序付きリストの番号付けを自動的に調整します。
さらに、 リストの番号付け ドロップダウンリストから番号付けスタイルを選択します:
連番: 各リスト項目に連続して番号を付けます (
1.、2.、3.)。 このオプションは Markdown ソースの番号付けをレンダリングされたリストと一致させ、ソースを読むときに項目の位置をすぐに分かるようにします。'1.' を使用: 新しい項目をすべて
1.として書き込みます。 このオプションでは Markdown レンダラーが番号付けを処理するため、リストの番号を手動で付け直さずに項目を挿入、削除、並べ替えしやすくなります。前の番号を使用: 新しい項目ごとに前の項目の番号を再利用します (例:
5.、5.、5.)。 このオプションでは、編集や並べ替えが簡単になり、リストの既存の開始番号が保持されます。
テーブル
DataGrip は、Markdown でテーブルの作成や編集をサポートします。
テーブルの挿入
Alt+Insert を押して 挿入… ポップアップを開き、 テーブル を選択します。
テーブルのサイズ（行と列の数）を選択します。
各セルの内容を入力し、 Tab を押してキャレットをあるセルから次のセルに移動します。 新しい行を追加するには、 Shift+Enter を押します。 入力すると、DataGrip は表のセル内容に合わせて行や列を自動で調整します。
テーブルの編集時に支援機能を無効にする方法については、 スマートキー: Markdown を参照してください。
DataGrip はフォーマットに誤りがあるテーブルをハイライトし、修正できるようにします。 リストからクイックフィックスを選択すると、DataGrip はクイックフィックスの適用結果を示すプレビューを表示します。
DataGrip はテーブルセルと列区切りをエディター内で自動的に整列し、テーブルのソーステキストを変更せずにテーブルを読みやすくします。 この位置合わせなしでテーブルを表示するには、 テーブルセルを視覚的に整列 を で無効にします。
デフォルトでは、DataGrip はエディターにテーブルの列と行のマーカーを表示します。 これらのマーカーを使用して、列と行を選択、移動、挿入、削除、整列します。 マーカーは、Markdown ファイル専用の特殊なタイプの インレイヒントです。 これらのマーカーが表示されない場合は、 Ctrl+Alt+S を押して IDE 設定を開き、 に移動して、 オプションをチェックしてください。
列マーカーをクリックして、次のアクションを実行します：
列を左に移動
列を右に移動
列を左に挿入
列を右に挿入
列セルの選択
左揃え
左右中央揃え
右揃え
列の除去
行マーカーをクリックして、次のアクションを実行します：
行を上に移動
行を下に移動
行を上に挿入
行を下に挿入- 行の選択
- 行の除去
コードブロック
フェンスで囲まれたコードブロックを挿入するには、コードブロックの前後にトリプルバッククォート ``` を使用します。 コードブロックの言語を指定すると、デフォルトで、Markdown エディターが 対応する言語を挿入します。
これにより、指定された言語の構文のハイライトとその他のコーディング支援機能が有効になります: 補完、 インスペクション 、および インテンションアクション。
コードブロックのコーディング支援を無効にする
コードブロックが構文的に正しいことを意図していない場合は、コードブロック内のコードインジェクションや構文エラーを無効にすることをお勧めします。
Ctrl+Alt+S を押して設定を開き、 を選択します。
次のオプションをクリアします：
コードフェンスに言語を注入
コードフェンスのエラーを表示
変更を適用するには、 OK をクリックします。
Markdown ファイルからコマンドを実行する
プロジェクトのクローンを作成する場合、通常、アプリケーションの実行、環境の構成などを行うための指示とコマンドを含む README.md ファイルがあります。 DataGrip はこれらのコマンドを検出し、コマンドを実行するためのガターアイコンを提供します。
対応するガターアイコンをクリックするか、キャレットが実行するコマンドにあるときに Ctrl+Shift+F10 を押します。
コマンド実行時に 作業ディレクトリとして使用するディレクトリを選択できます: 親ファイルディレクトリまたはプロジェクトディレクトリ。
IDE 設定 Ctrl+Alt+S の で Markdown ファイルのコマンドを実行するためのガターアイコンを無効にすることができます: Markdown ファイルから直接実行できるコマンドを検出 チェックボックスをオフにします。
詳細については、 Markdown 言語設定 を参照してください。
数式
Markdown プラグインは数式を追加するための TeX および LaTeX 構文をサポートしています。 インライン数式にはシングルドル記号 $...$ を、数式ブロックにはダブルドル記号 $$...$$ を使用します。
リテラルのドル記号を挿入したい場合は、バックスラッシュでエスケープしてください： \$ または \$$。
ダイアグラム
Markdown エディターは、 Mermaid(英語) および PlantUML(英語) で定義されたダイアグラムをレンダリングできます。 これはデフォルトで無効になっており、追加の手順が必要です。
Mermaid ダイアグラムのサポートを有効にする
Ctrl+Alt+S を押して設定を開き、 を選択します。
Mermaid(英語) プラグインを見つけてインストールします。
PlantUML ダイアグラムのサポートを有効にする
Ctrl+Alt+S を押して設定を開き、 を選択します。
PlantUML を Markdown 拡張機能 にインストールして有効にします。
DataGrip が関連する拡張機能をダウンロードしたら、 OK をクリックして変更を適用します。
目次
DataGrip では、ドキュメント内の見出しから目次を生成できます。
目次の生成
現在のファイルで利用可能なヘッダーの適切にインデントされたリストを生成できます。
現在のファイルの目次を追加する場所にキャレットを置き、 Alt+Insert を押して 挿入… ポップアップを開きます。
目次 を選択します。
このファイルにすでに目次がある場合は、いくつかのヘッダーを追加、削除、名前変更した後で、 目次を更新 を選択して更新します。
目次は <!-- TOC --> コメントタグで囲まれています。
目次から見出しを省略する
特定の見出しを目次から除外できます。
省略する見出しにキャレットを置き、 Alt+Enter を押して、 目次から見出しを省略する を選択します。
IDE は <!-- omit from toc --> を見出しの前に挿入し、その見出しを目次から除外します。
Markdown のプレビュー
デフォルトでは、Markdown エディターには、Markdown ソースの隣にレンダリングされた HTML コードのプレビューペインが表示されます。 Markdown エディターの右上隅にある 
エディター または 
プレビュー をクリックすると、エディターまたはプレビューペインのみを表示できます。
エディターを分割して水平方向にプレビュー
デフォルトでは、エディターとプレビューは垂直（サイドバイサイド）に分割され、ワイドモニターで便利です。 また、水平に分割してプレビューをエディターの下部に表示することもでき、縦型ディスプレイにより便利です。
エディターの右上隅にある
をクリックして、 エディタープレビュー ペインを開きます。
をクリックして、エディターとプレビューを水平に分割します。
プレビューのデフォルトのレイアウトを構成するには、 の プレビューレイアウト リストを使用できます。
エディターを無効にし、スクロールバーの同期をプレビューする
デフォルトでは、エディターとプレビューペインのスクロールバーは同期されています。つまり、プレビューペインの場所はソースの場所に対応しています。
Ctrl+Alt+S を押して設定を開き、 を選択します。
エディターでスクロールを同期してプレビューする をクリアします。
変更を適用するには、 OK をクリックします。
プレビューのフォントサイズを変更する
CSS をカスタマイズすることでプレビューのフォントサイズを定義することもできますが、組み込みのスタイルシートのフォントサイズを設定することもできます。
Ctrl+Alt+S を押して設定を開き、 を選択します。
プレビューフォントサイズ フィールドでフォントサイズを設定します。
変更を適用するには、 OK をクリックします。
プレビューのフォントサイズを頻繁に調整する必要がある場合は、設定で変更するのではなく、次の 2 つのアクションにショートカットを割り当てます: プレビュー フォントサイズの拡大 と プレビュー フォントサイズの縮小。
カスタム CSS
DataGrip はプレビューペインで HTML をレンダリングするためのデフォルトのスタイルシートを提供します。 これらのスタイルシートはデフォルトの UI テーマと一貫性があるように設計されています。 特定の CSS ルールを設定して表示を細かく変更できます。例えば、見出しのフォントサイズやリストの行間を変更できます。 また、期待する出力により近づけるために、まったく新しい CSS を指定することもできます。例えば、 GitHub Markdown スタイルを再現したい場合などです。
HTML プレビューをレンダリングするための CSS の構成
Ctrl+Alt+S を押して設定を開き、 を選択します。
カスタム CSS で設定を構成します。
ロード場所 を選択して、カスタム CSS ファイルの場所を指定します。
CSS ルール ルールを選択して、オーバーライドする特定の CSS ルールを入力します。
変更を適用するには、 OK をクリックします。
カスタム CSS ルールの例を次に示します：
Markdown ファイルを再フォーマットする
DataGrip は、適切な行折り返し・空白行・インデントを使用して Markdown ファイルを 再フォーマットできます。
ビルドの実行時、またはその他のアクション時に、VCS コミットで自動的に再フォーマットをトリガーできます。または、いつでも手動で再フォーマットを呼び出すことができます。
メインメニューで、 に移動するか、 Ctrl+Alt+L を押します。
DataGrip は、Markdown ファイルの コードスタイル設定に従って内容をフォーマットします。
Markdown コードスタイル設定を構成する
Ctrl+Alt+S を押して設定を開き、 を選択します。
行を折り返して段落を埋める
デフォルトでは、DataGrip は長い行にハードラップを自動で追加しません。 ファイルを再フォーマットすると行が折り返されます。
Ctrl+Alt+S を押して設定を開き、 を選択します。 入力時に自動改行を有効にするには、 Markdown コードスタイル設定を設定します。
あるいは、設定した最大行長を超える段落を維持するために、ハードラップを完全に無効にできます。 の 長いテキストの折り返し オプションを無効にしてください。
アクションを使用して、キャレットがある段落にのみ改行を追加することもできます。
ドキュメント内を移動して管理する
大きな Markdown ファイル内を移動する
構造 ツールウィンドウ Alt+7 または ファイル構造 ポップアップ Ctrl+F12 を使用して、関連する見出しを表示して移動します。
Markdown ファイルにコメントを追加する
Markdown には、行をコメントアウトするための専用の構文はありません。 ただし、次のように、アドレスのないリンクラベルを使用してコメント行をエミュレートすることは可能です。
コメントアウトする行にキャレットを置き、 Ctrl+/ を押します。
これにより、コメントアウトされたテキストが括弧で囲まれ、必要に応じてその前に空白行が含まれるリンクラベルが追加されます。 コメントを解除するには、同じショートカットを押します。
Markdown のハイライトをカスタマイズする
DataGrip は カラースキーム設定に従ってさまざまな Markdown 要素をハイライトします。
設定 ダイアログ (Ctrl+Alt+S) で、 エディター | カラースキームの切り替え | Markdown を選択します。
カラースキームを選択するか、デフォルトから継承されたハイライト設定を受け入れるか、 色とフォント の説明に従ってカスタマイズします。
Markdown ファイルを変換する
Markdown プラグインは、Markdown ファイルを HTML と PDF にエクスポートできます。 Pandoc(英語) を設定すると、Microsoft Word ファイル（DOCX）へのエクスポートとインポートも可能になります。
Pandoc の構成
DataGrip は Pandoc インストールを自動的に検出できるはずです。 そうでない場合は、以下を実行します。
メインメニューで へ移動します。
Pandoc 設定 で、Pandoc 実行可能ファイルの場所と、MicrosoftWord ドキュメントからインポートしたイメージを保存する場所を指定します。
変更を適用するには、 OK をクリックします。
MicrosoftWord からインポート
メインメニューで へ移動します。
ドキュメントの場所を指定します。
Markdown ファイルを別の形式にエクスポートする
DataGrip は Microsoft Word（Pandoc が必要 ）、PDF、HTML へのエクスポートに対応しています。
- エディターとプレビュー または プレビュー をクリックして、エディターに HTML プレビューペインを表示します。
メインメニューで へ移動します。
Markdown のエクスポート ダイアログで、出力ファイルの名前、場所、形式を指定して、 OK をクリックします。
