Markdown

コードブロックのコーディング支援を無効にする

コードブロックが構文的に正しいことを意図していない場合は、コードブロックのコードインジェクションと構文エラーを無効にすることをお勧めします。

1. Ctrl+Alt+S を押して設定を開き、 言語 & フレームワーク | Markdown を選択します。

2. 次のオプションをクリアします。

   • コードフェンスに言語を注入

   • コードフェンスの問題を表示

3. 変更を適用するには、 OK をクリックします。

Markdown ファイルからコマンドを実行する

プロジェクトのクローンを作成する場合、通常、アプリケーションの実行、環境の構成などを行うための指示とコマンドを含む README.md ファイルがあります。 IntelliJ IDEA はこれらのコマンドを検出し、コマンドを実行するためのガターアイコンを提供します。

• 対応するガターアイコンをクリックするか、キャレットが実行するコマンドにあるときに Ctrl+Shift+F10 を押します。

  

IDE 設定 Ctrl+Alt+S の 言語& フレームワーク | Markdown で Markdown ファイルのコマンドを実行するためのガターアイコンを無効にすることができます: Markdown ファイルから直接実行できるコマンドを検出 チェックボックスをオフにします。

詳細については、 Markdown 言語設定 を参照してください。

Mermaid ダイアグラムのサポートを有効にする

1. Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。

2. Mermaid(英語) プラグインを見つけてインストールします。

PlantUML ダイアグラムのサポートを有効にする

1. Ctrl+Alt+S を押して設定を開き、 言語 & フレームワーク | Markdown を選択します。

2. PlantUML を Markdown 拡張機能 にインストールして有効にします。

3. IntelliJ IDEA が関連する拡張機能をダウンロードしたら、 OK をクリックして変更を適用します。

エディターを分割して水平方向にプレビュー

デフォルトで、エディターとプレビューは縦に（並列で）分割されており、ワイド モニターに便利です。 横に分割し、エディターの下部にプレビューを表示することもでき、縦長ディスプレイにより便利です。

1. エディターの右上隅にある をクリックして、 エディタープレビュー ペインを開きます。

2. をクリックして、エディターとプレビューを水平に分割します。

プレビューのデフォルトのレイアウトを構成するには、 言語 & フレームワーク | Markdown の プレビューの​​レイアウト リストを使用できます。

エディターを無効にし、スクロールバーの同期をプレビューする

デフォルトでは、エディターとプレビューペインのスクロールバーは同期されています。つまり、プレビューペインの場所はソースの場所に対応しています。

1. Ctrl+Alt+S を押して設定を開き、 言語 & フレームワーク | Markdown を選択します。

2. エディターでスクロールを同期してプレビューする をクリアします。

3. 変更を適用するには、 OK をクリックします。

プレビューのフォントサイズを変更する

CSS をカスタマイズすることでプレビューのフォントサイズを定義することもできますが、組み込みのスタイルシートのフォントサイズを設定することもできます。

1. Ctrl+Alt+S を押して設定を開き、 言語 & フレームワーク | Markdown を選択します。

2. プレビューフォントサイズ フィールドでフォントサイズを設定します。

3. 変更を適用するには、 OK をクリックします。

プレビューのフォントサイズを頻繁に調整する必要がある場合は、設定で変更するのではなく、次の 2 つのアクションにショートカットを割り当てます: プレビューフォントサイズの拡大 と プレビューフォントサイズの縮小。

画像の挿入

1. Ctrl+U を押す。

   または、 Alt+Insert を押して 挿入… ポップアップを開き、 画像 を選択します。

   

2. 画像の挿入 ダイアログでイメージへのパスを指定します。

   

3. OK をクリックします。

リンクを挿入

• Ctrl+Shift+U を押す。

  または、 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)

IntelliJ IDEA は、現在のコンテキストで使用可能なリンクラベル（現在のファイルに関連するファイルと有効なヘッダーラベル）の補完を提供します。

参照されるヘッダーに移動するためのリンクラベルの Ctrl+Click。

ヘッダーまたはラベルで 使用箇所の検索(U) Alt+F7 を呼び出すと、このラベルを指すすべてのリンクを表示できます。 ヘッダーまたはラベルで 名前の変更 リファクタリング Shift+F6 を呼び出して、関連するすべての使用箇所とともに名前を変更することもできます。

目次の生成

現在のファイルで使用可能なヘッダーの適切にインデントされたリストを生成できます。

1. 現在のファイルの目次を追加する場所にキャレットを置き、 Alt+Insert を押して 挿入… ポップアップを開きます。

2. 目次 を選択します。

   

   このファイルにすでに目次がある場合は、いくつかのヘッダーを追加、削除、名前変更した後で、 目次の更新 を選択して更新します。

目次は <!-- TOC --> コメントタグで囲まれています。

テーブルの挿入

1. Alt+Insert を押して 挿入… ポップアップを開き、 テーブル を選択します。

   

2. テーブルのサイズ（行と列の数）を選択します。

3. 各セルの内容を入力し、 Tab を押してキャレットをあるセルから次のセルに移動します。 新しい行を追加するには、 Shift+Enter を押します。 入力すると、IntelliJ IDEA は行と列を自動的に調整して、表のセルの内容に適切に適合させます。

   テーブル編集時の支援機能の無効化については、 スマートキー: Markdown を参照してください。

フローティングツールバーをカスタマイズする

1. Ctrl+Alt+S を押して設定を開き、 外観 & 振る舞い | メニューおよびツールバー を選択します。

2. Markdown エディターのフローティングツールバー で必要なアクションを追加または削除します。

   詳細については、 メニューおよびツールバー を参照してください。

3. 変更を適用するには、 OK(O) をクリックします。

フローティングツールバーを非表示にする

1. Ctrl+Alt+S を押して設定を開き、 詳細設定 を選択します。

2. Markdown で フローティングツールバーの非表示 を選択します。

3. 変更を適用するには、 OK(O) をクリックします。

ビルドの実行時、またはその他のアクション時に、VCS コミットで自動的に再フォーマットをトリガーできます。または、いつでも手動で再フォーマットを呼び出すことができます。

• メインメニューで、 コード | コードの整形 に移動するか、 Ctrl+Alt+L を押します。

Markdown コードスタイル設定を構成する

• Ctrl+Alt+S を押して設定を開き、 エディター | コードスタイル | Markdown を選択します。

詳細については、 Markdown コードスタイル設定 を参照してください。

Pandoc の構成

IntelliJ IDEA は、Pandoc のインストールを自動的に検出できるはずです。 そうでない場合は、以下を実行します。

1. メインメニューで ツール(T) | Markdown | Pandoc の構成… へ移動します。

2. Pandoc 設定 で、Pandoc 実行可能ファイルの場所と、MicrosoftWord ドキュメントからインポートしたイメージを保存する場所を指定します。

3. 変更を適用するには、 OK をクリックします。

MicrosoftWord からインポート

1. メインメニューで ツール(T) | Markdown | Word 文書のインポート… へ移動します。

2. ドキュメントの場所を指定します。

Markdown ファイルを別の形式にエクスポートする

IntelliJ IDEA は、Microsoft Word (Pandoc が必要 )、PDF、HTML にエクスポートできます。

1. エディターとプレビュー または プレビュー をクリックして、エディターに HTML プレビューペインを表示します。

2. メインメニューで ツール(T) | Markdown | Markdown のエクスポート先… へ移動します。

3. Markdown のエクスポート ダイアログで、出力ファイルの名前、場所、形式を指定して、 OK(O) をクリックします。

   

Markdown のハイライトをカスタマイズする

IntelliJ IDEA は、 配色設定に従ってさまざまな Markdown 要素をハイライトします。

1. 設定 ダイアログ（Ctrl+Alt+S ）で、 エディター | カラースキーム | Markdown を選択します。

2. 配色を選択するか、デフォルトから継承されたハイライト設定を受け入れるか、または 色とフォント に記載されているとおりにカスタマイズします。

大きな Markdown ファイルで移動する

• 構造 ツールウィンドウ Alt+7 または ファイル構造 ポップアップ Ctrl+F12 を使用して、関連する見出しを表示して移動します。

Markdown ファイルにコメントを追加する

Markdown には、行をコメントアウトするための専用の構文はありません。 ただし、次のように、アドレスのないリンクラベルを使用してコメント行をエミュレートすることは可能です。

コメントアウトする行にキャレットを置き、 Ctrl+/ を押します。

これにより、コメントアウトされたテキストが括弧で囲まれ、必要に応じてその前に空白行が含まれるリンクラベルが追加されます。 コメントを解除するには、同じショートカットを押します。

行を折り返して段落を埋める

デフォルトでは、IntelliJ IDEA は長い行にハードラップを自動的に追加しません。 ファイルを再フォーマットすると行が折り返されます。

• Ctrl+Alt+S を押して設定を開き、 エディター | コードスタイル | Markdown を選択します。 入力時に自動改行を有効にするには、 Markdown コードスタイル設定を設定します。

• あるいは、ハードラップを完全に無効にして、構成された最大行長よりも長い段落を保持します。 設定 | エディター | コードスタイル | Markdown で 長いテキストの折り返し オプションを無効化します。

• 編集(E) | 段落を整形 アクションを使用して、キャレットがある段落にのみ改行を追加することもできます。