VSCodeでMarkdownをプレビューするショートカットは？

Windows/LinuxはCtrl+Shift+V、MacはCmd+Shift+Vでプレビューをタブとして開きます。エディタと横に並べて表示するにはCtrl+K V（MacはCmd+K V）を使います。拡張機能のインストールは不要で、VSCode標準機能です。

VSCodeのプレビューが表示されない・真っ白になるのはなぜですか？

開いているファイルがMarkdownとして認識されていない（拡張子が.mdでない、言語モードが違う）ことが最も多い原因です。右下の言語モードをMarkdownに変更してください。また、セキュリティ設定によりプレビュー内のスクリプトや一部コンテンツがブロックされることもあります。

VSCodeのプレビューとGitHubの表示は同じですか？

概ね同じですが完全には一致しません。VSCodeのプレビューはCommonMarkベース＋GFMの一部対応で、GitHub側の細かい仕様（相対リンクの解決、絵文字、アラート記法など）と差が出ることがあります。最終確認は実際の表示先で行うのが確実です。

VSCodeでMarkdownをプレビューする方法

VSCode（Visual Studio Code）には、拡張機能なしで使えるMarkdownプレビュー機能が標準搭載されています。このページでは、基本のショートカットから、書きながら確認できる横並び表示、より快適にするおすすめ拡張機能、プレビューが出ないときの対処法までまとめました。

プレビュー操作の早見表
操作	Windows / Linux	Mac
プレビューを開く	`Ctrl`+`Shift`+`V`	`Cmd`+`Shift`+`V`
横に並べてプレビュー	`Ctrl`+`K` → `V`	`Cmd`+`K` → `V`
コマンドパレット	`Ctrl`+`Shift`+`P` →「Markdown: プレビューを開く」	`Cmd`+`Shift`+`P` → 同左

基本：ショートカットでプレビューを開く

.md ファイルを開いた状態で Ctrl+Shift+V（Macは Cmd+Shift+V）を押すと、整形されたプレビューが新しいタブで開きます。エディタ右上の虫眼鏡付きのプレビューアイコンをクリックしても同じです。

プレビューは編集内容にリアルタイムで追従し、エディタのスクロールとも同期します。

おすすめ：横並びプレビューで書きながら確認

執筆中は、エディタとプレビューを左右に並べる表示が圧倒的に快適です。Ctrl+K を押してから V（Macは Cmd+K → V）で、編集画面の横にプレビューが開きます。

2つのキーを「順番に」押すショートカット（コード）です。Ctrl+K を押して一拍おいてから V を単独で押してください。同時押しではありません。

より快適にするおすすめ拡張機能

拡張機能	できること
Markdown All in One	目次の自動生成、太字のショートカット（Ctrl+B）、リストの自動継続、表の整形など総合支援。まず入れるならこれ
markdownlint	記法の揺れ（見出しレベルの飛び・行末スペース等）を静的チェック。チームでの品質統一に
Markdown Preview Enhanced	数式（LaTeX）・図表（mermaid）・PDF出力など標準プレビューを大幅強化
Excel to Markdown table	Excelからコピーした表をMarkdownテーブルとして貼り付け（表の変換方法参照）
Paste Image	クリップボードの画像を保存しつつ画像リンクを挿入

拡張機能は左側のブロックアイコン（拡張機能ビュー）から名前で検索してインストールします。

プレビューが表示されない時の対処法

症状	原因と対処
ショートカットが効かない	ファイルがMarkdownとして認識されていない。右下の言語モード表示を確認し、「Markdown」に変更する。拡張子を `.md` にするのが確実
プレビューが真っ白	拡張機能の競合が典型。拡張機能を無効化して切り分けるか、コマンドパレットから「開発者: ウィンドウの再読み込み」を実行
画像が表示されない	画像パスがファイルからの相対パスになっているか確認。ワークスペース外の画像はセキュリティ設定でブロックされることがある
HTMLタグが反映されない	プレビューのセキュリティ設定が原因。プレビュー右上の「…」→「プレビューのセキュリティ設定の変更」で調整（信頼できる内容のみ）
スクロールが同期しない	設定の `markdown.preview.scrollPreviewWithEditor` を確認

プレビューと実際の表示の違いに注意

VSCodeのプレビューはCommonMarkベース（＋GFMの一部）で、GitHubやブログでの最終表示と細部が異なることがあります。よくある差は次のとおりです。

改行の扱い（ソフトブレイクの表示）が表示先と異なる — サービスごとの改行の違い参照
GitHub特有の記法（アラート、タスクリストの表示など）は差が出やすい
数式・mermaidは標準プレビューでは表示されない（拡張機能が必要）

「VSCodeでは綺麗だったのに、貼り付け先で崩れた」を防ぐには、最終的な表示先か、それに近い環境での確認が確実です。ブラウザだけでサッと確認したいときは、インストール不要のMarkdownビューアーにコピペする方法もあります。VSCodeを開くまでもない「もらったファイルをちょっと見たい」場面ではこちらの方が速いです。

VSCodeを開くほどでもないときは。
ブラウザに貼り付けるだけで即プレビュー。フォントや余白の調整、ブログ用CSS/HTML出力もできます。

無料のMarkdownビューアーを開く

よくある質問

プレビューのデザイン（CSS）は変えられますか？

はい。設定の markdown.styles に自作CSSファイルのパスを指定すると、プレビューに適用されます。ブログの本番CSSを指定しておくと、実際の見た目に近い状態で執筆できます。

プレビューをそのままHTMLとして保存できますか？

標準機能にはありません。「Markdown Preview Enhanced」拡張機能のHTMLエクスポートを使うか、Markdownビューアーの「HTMLコピー」機能で整形済みHTMLを取得してください。変換方法の全体像はMarkdown→HTML変換の方法まとめで解説しています。

プレビューだけを常に開いた状態にできますか？

プレビュータブは通常のタブと同じように固定（ピン留め）できます。また「プレビューのロック」を使うと、他のファイルに切り替えてもプレビュー対象を固定できます。