WebStorm 2026.3 Help

Markdown

Markdown (英語) は、フォーマット要素をプレーンテキストに追加するための軽量のマークアップ言語です。 WebStorm は Markdown ファイルを認識し、ハイライト、補完、フォーマットを備えた専用エディターを提供します。 サポートは CommonMark 仕様に基づいています。

Markdown プラグインを有効にする

この機能は、デフォルトで WebStorm にバンドルされ有効になっている Markdown プラグインに依存しています。 関連機能が利用できない場合は、プラグインが無効になっていないことを確認してください。

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

  2. Markdown プラグインを見つけて、 有効化 をクリックします。

新しい Markdown ファイルを作成する

デフォルトでは、WebStorm は .md または .markdown 拡張子を持つファイルを Markdown ファイルとして認識します。

  1. プロジェクト ツールウィンドウ(Alt+1 )でディレクトリを右クリックし、 新規 | ファイル を選択します。

    または、必要なディレクトリを選択し、 Alt+Insert を押してから、 ファイル を選択できます。

  2. 認識された拡張子を持つファイルの名前を入力します(例: readme.md )。

Markdown エディターは、テキストフラグメント選択時に表示される フローティングツールバーにいくつかの基本的なフォーマットアクションを提供します。 プレビューペインを使用して、レンダリングされた HTML を表示できます。

Markdown エディターのフォーマットツールバー

たとえばソースコードや画像、他の Markdown ファイルへの参照が必要な場合は、現在の project 内のファイルへのリンクの 補完も利用できます。 詳細については、 リンク を参照してください。

Markdown エディターの補完ポップアップ

Markdown をフォーマットする

フローティングツールバー

Markdown ファイルでテキストを選択すると、WebStorm はさまざまなフォーマットオプションを備えたフローティングツールバーを表示します。 Markdown フローティングツールバー 通常のテキストと、 H1 から H6 までのレベルのヘッダーを切り替えられます。

  • 太字太字 Ctrl+B

  • 斜体斜体 Ctrl+I

  • 取り消し線取り消し線 Ctrl+Shift+S

  • コードコード Ctrl+Shift+C

  • リンク作成リンク作成 Ctrl+Shift+U

  • 箇条書きリスト箇条書きリスト

  • 番号付きリスト番号付きリスト

  • チェックマークリストチェックマークリスト

編集アクションを備えた Markdown ツールバー

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

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

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

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

    詳細は、 メニューとツールバー を参照してください。

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

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

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

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

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

次の構文でリンクを定義できます:

[link-text](link-url "optional-title")
Markdown ファイルにリンクを挿入する
  • Ctrl+Shift+U を押す。

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

    Markdown ファイルにリンクを挿入する

一部のテキストがハイライトされている場合は、リンクのテキストとして [ ] で囲まれます。 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)

WebStorm は、現在のコンテキストで利用可能なリンクラベル、つまり現在のファイルを基準としたファイルと有効なヘッダーラベルの補完を提供します:

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

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

イメージ

デフォルトでは、Markdown は画像に次の構文を使用します。これは、project 内のパス補完を利用して入力できます:

![alt-text](path/to/file.png "optional-title")
Markdown ドキュメントに挿入されたイメージ

画像の挿入

  1. Ctrl+U を押す。

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

    イメージの追加を選択
  2. 画像の挿入 ダイアログで画像へのパスを指定し、 OK をクリックします。

    Markdown: 画像の挿入ダイアログ

イメージを設定するには、イメージが挿入されている行のガターで 画像設定アイコン をクリックします。 例: 画像の挿入 および 画像の構成 ダイアログで HTML に変換 を選択して、生の HTML マークアップを含むイメージを Markdown ファイルに挿入できます。

Insert Image with raw HTML

リスト

Markdown では、順序なしリストに、スペースが続く -、 *,、 + を使用でき、順序付きリストに、ピリオドが続く番号 (1。、 2。、 3。) を使用できます。 チェックボックス付きのタスクリストには、 - [x] を使用できます。 簡単にフォーマットするには、 フローティングツールバー を使用します。

Markdown ファイルに表示されるさまざまな種類のリスト

IDE は入力時にリストのインデントを階層に合わせて自動的に調整します。 設定でこの動作を無効にできます: Ctrl+Alt+S を押して設定を開き、 エディター | 一般 | スマートキー | Markdown を選択して、 入力時にインデントを調整する を無効にします。

リストの番号付けを構成する

WebStorm で順序付きリストに番号を付ける方法を制御できます。

  1. Ctrl+Alt+S を押して設定を開き、 エディター | 一般 | スマートキー | Markdown を選択します。

  2. リスト セクションで、 入力時にリスト番号を再割り当て を有効にします。

    WebStorm は入力時に順序付きリストの番号付けを自動的に調整します。

  3. さらに、 リストの番号付け ドロップダウンリストから番号付けスタイルを選択します:

    • 連番: 各リスト項目に連続した番号を付けます (1。、 2。、 3。)。 このオプションは、Markdown ソースの番号付けをレンダリングされたリストと一致させ、ソースを読むときに項目の位置をすぐに分かるようにします。

    • '1.' を使用: 新しい各項目を 1。 として記述します。 このオプションでは、Markdown レンダラーで番号付けを処理できるため、リストの番号を手動で付け直さずに項目を挿入、削除、または並べ替えやすくなります。

    • 前の番号を使用: 新しい各項目に前の項目の番号を再利用します (例: 5.、 5.、 5.)。 このオプションにより、編集や並べ替えが簡単になり、リストの既存の開始番号が保持されます。

テーブル

WebStorm は Markdown におけるテーブルの作成と編集をサポートします。

テーブルの挿入

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

    Markdown ファイルにテーブルを挿入する
  2. テーブルのサイズ(行と列の数)を選択します。

  3. 各セルの内容を入力し、 Tab を押してキャレットをあるセルから次のセルに移動します。 新しい行を追加するには、 Shift+Enter を押します。 入力中、WebStorm はテーブルセルの内容に合わせて行と列を自動調整します。

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

WebStorm はフォーマットが不正なテーブルをハイライトし、修正できるようにします。 リストからクイックフィックスを選択すると、WebStorm はクイックフィックスの適用結果を示すプレビューを表示します。

Markdown インスペクション (誤ってフォーマットされたテーブルの場合)

WebStorm はテーブルのソーステキストを変更せずに、エディターでテーブルセルと列区切りを自動的に揃え、テーブルを読みやすくします。 この位置合わせなしでテーブルを表示する場合は、 設定 | 言語 & フレームワーク | Markdown で テーブルのセルを視覚的に整列 を無効にします。

|One |Two |Three |Four | |--- |--- |--- |--- | | | | | | | | | | | | | | | |
|One |Two |Three |Four | |---|---|---|---| | | | | | | | | | | | | | | |

デフォルトでは、WebStorm はエディターにテーブルの列および行マーカーを表示します。 これらのマーカーを使用して、列と行を選択、移動、挿入、削除、整列します。 マーカーは Markdown ファイル特有の特別な インレイヒントです。 これらのマーカーが表示されない場合は、 Ctrl+Alt+S を押して IDE 設定を開き、 エディター|インレイヒント に移動し、 その他 | Markdown | テーブルインレイ オプションをチェックしてください。

Markdown ファイルのテーブルの編集

列マーカーをクリックして、次のアクションを実行します:

  • 列を左に移動 ボタン列を左に移動

  • 列を右に移動 ボタン列を右に移動

  • 左に列を挿入 ボタン左に列を挿入

  • 右に列を挿入 ボタン右に列を挿入

  • 列セル選択 ボタン列のセルを選択

  • 左揃え ボタン左寄せ

  • 中央揃え ボタン中央寄せ

  • 右揃え ボタン右寄せ

  • 列削除 ボタン列を削除

行マーカーをクリックして、次のアクションを実行します:

  • 行を上に移動 ボタン行を上に移動

  • 行を下に移動 ボタン行を下に移動

  • 上に行を挿入 ボタン上に行を挿入

  • 下に行を挿入 ボタン下に行を挿入

  • 行選択 ボタン行を選択

  • 行削除 ボタン行を削除

コードブロック

フェンスで囲まれたコードブロックを挿入するには、コードブロックの前後にトリプルバッククォート ``` を使用します。 コードブロックの言語を指定すると、デフォルトで、Markdown エディターが 対応する言語を挿入します。

フェンスドコードブロックでの Markdown 完了: 言語を選択する

これにより、指定された言語の構文のハイライトとその他のコーディング支援機能が有効になります: 補完、 インスペクション 、および インテンションアクション。

フェンスドコードブロックでの Markdown 完了

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

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

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

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

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

    • コードフェンス内のエラーを表示

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

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

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

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

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

数式

Markdown プラグインは、ドキュメントに数式を追加するために TeX および LaTeX 構文をサポートしています。 インライン数式には single dollar 文字 $...$ を、数式ブロックには double dollar 文字 $$...$$ を使用します。

Markdown の数式

リテラルのドル記号を挿入したい場合は、バックスラッシュでエスケープしてください: \$ または \$$。

ダイアグラム

Markdown エディターは、 Mermaid(英語) および PlantUML(英語) で定義されたダイアグラムをレンダリングできます。 これはデフォルトで無効になっており、追加の手順が必要です。

Markdown の Mermaid ダイアグラム

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

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

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

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

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

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

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

目次

WebStorm では、ドキュメント内の見出しから目次を生成できます。

目次の生成

現在のファイルで利用可能なヘッダーの、インデント付きリストを生成できます。

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

  2. 目次 を選択します。

    Markdown ファイルに目次を作成する

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

    Markdown ファイルの TOC を更新する

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

目次が挿入されました

目次から見出しを省略する

特定の見出しを目次から除外できます。

  • 省略する見出しにキャレットを置き、 Alt+Enter を押して、 目次から見出しを省略する を選択します。

IDE は、目次からこの見出しを除外する <!-- omit from toc --> を見出しの前に挿入します。

Markdown をプレビュー

デフォルトでは、Markdown エディターには、Markdown ソースの隣にレンダリングされた HTML コードのプレビューペインが表示されます。 Markdown エディターの右上隅にある エディター ボタンエディター または プレビュー ボタンプレビュー をクリックすると、エディターまたはプレビューペインのみを表示できます。

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

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

  • Markdown ファイルのあるタブのヘッダーを右クリックし、 スプリットダウンから を選択します。

Markdown editor and live preview pane

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

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

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

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

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

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

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

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

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

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

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

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

カスタム CSS

WebStorm はプレビューペインで HTML をレンダリングするためのデフォルトスタイルシートを提供します。 これらのスタイルシートはデフォルトの UI テーマと整合するよう設計されています。 特定の CSS ルールを設定して、見た目を細かく調整できます。例えば、見出しのフォントサイズやリスト内の行間などを変更できます。 また、期待される出力により合うように新しい CSS を指定することもできます。例えば、 GitHub Markdown スタイルを再現したい場合などです。

デフォルトの Markdown CSS
GitHub レンダリングスタイルに似たカスタム CSS を使用した Markdown プレビュー

HTML プレビューをレンダリングするための CSS の構成

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

  2. カスタム CSS で設定を構成します。

    • 指定ファイルからロード を選択して、カスタム CSS ファイルの場所を指定します。

    • CSS ルール ルールを選択して、オーバーライドする特定の CSS ルールを入力します。

    カスタム CSS ファイルを指定する
  3. 変更を適用するには、 OK をクリックします。

カスタム CSS ルールの例:

body { background: #DDDDDD; color: #888888; font-size: 250% !important; } strong { text-decoration: underline; }

Markdown ファイルを再フォーマットする

WebStorm では、改行や空白行、インデントが適切な Markdown ファイルの 再フォーマットが可能です。

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

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

WebStorm は Markdown ファイルの コードスタイル 設定に従って内容をフォーマットします。

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

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

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

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

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

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

  • また、設定した最大行長を超える段落を保つために、ハードラップを完全に無効化することもできます。 設定 | エディター | コードスタイル | Markdown の 長いテキストの折り返し オプションを無効にしてください。

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

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

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

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

[//]: # (Your comment text)

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

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

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

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

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

    2. 配色を選択してデフォルト継承のハイライト設定を受け入れるか、 カラースキーム:エディターのフォントと色彩 の説明に従ってカスタマイズします。

    Markdown ファイルを変換する

    Markdown プラグインは、Markdown ファイルを HTML と PDF にエクスポートできます。 Pandoc(英語) を設定すると、Microsoft Word ファイル(DOCX)へのエクスポートとインポートも可能になります。

    Pandoc の構成

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

    1. メインメニューで ツール | Markdown | Pandoc の設定… へ移動します。

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

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

    MicrosoftWord からインポート

    1. メインメニューで ツール | Markdown | Word ドキュメントをインポート… へ移動します。

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

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

    WebStorm は Microsoft Word(Pandoc が必要 )、PDF、HTML へのエクスポートが可能です。

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

    2. メインメニューで ツール | Markdown | Markdown ファイルをエクスポート… へ移動します。

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

      Markdown エクスポートダイアログ
    2026 年 11 月 6 日