44 lines · 609 chars
Markdown
プレビュー
エンコード & テキスト
Markdown プレビュー
Markdown プレビューは、入力中の Markdown を整形済みのページとして見せる機能です。左側に書いて貼り付け、右側でレンダリング結果を読みます。これはブラウザだけで動くライブ Markdown ビューアです。ディスクから .md ファイルを開くか、リポジトリの README をそのまま貼り付ければ、入力に合わせてプレビューが更新されます。GitHub Flavored Markdown 対応なので、表・タスクリスト・取り消し線・フェンス付きコードブロックも期待どおりに表示されます。入力内容はアップロードされず、アカウントも不要です。
できること
入力しながらライブプレビュー
左側のエディタに書くと、右側のレンダリング結果がその場で更新されます。プレビューボタンも再読み込みも不要 —— これはライブ Markdown プレビューであり、別工程のレンダリングではありません。
.md ファイルを開く、またはドロップ
ディスク上の Markdown をそのまま読めます。.md を選ぶ、エディタにドラッグする、またはリポジトリからコピーした README を貼り付けてください。読み込み次第、プレビューが埋まります。
GitHub Flavored Markdown
表、タスクリスト、取り消し線、自動リンク、脚注、フェンス付きコードブロックは GitHub と同じ規則でレンダリングされます。プッシュ前に README の見え方を確認できます。
追従する目次
文書内の見出しがクリック可能なアウトラインにまとまり、アンカーは GitHub と同じです。見出しをクリックしてジャンプできるので、長い README もスクロールだけの塊ではなく、ナビできる文書になります。
数式の組版と PDF 保存
ドル記号で囲んだ LaTeX 数式は、多くの Markdown サイトと同じ LaTeX 風の数式 で組版されます。文書ができたらプレビューを印刷し、ブラウザから PDF として保存 —— 文字は鮮明で選択でき、数式も残ります。
既定で安全、完全にローカル
Markdown に埋め込まれた生 HTML は実行されないため、文書がブラウザでスクリプトを走らせることはありません。レンダリングは端末上で完結:アップロードなし、アカウントなし、サーバーにファイルのコピーも残りません。
使い方
- 01
エディタに Markdown を入れます。入力、貼り付け、ディスクから .md を選ぶ、ページにドロップ、のいずれかで。プレビューの動きだけ見たい場合は、サンプル README が読み込まれます。
- 02
右側でレンダリング結果を読みます。入力中にプレビューが更新され、見出し・表・リスト・リンク・数式・コードブロックが公開時と同じ見え方になります。仕切りをドラッグして左右の幅を変えるか、スマホでは「編集 / プレビュー」タブを切り替えます。
- 03
必要な出力を取ります。CMS やドキュメント用にレンダリング済み HTML をコピーし、.md としてダウンロードし、または PDF をエクスポート を押してブラウザの印刷ダイアログから保存します。終わったらエディタをクリア —— すべて端末上で完結しています。
Markdown プレビューとは何か、いつ必要か
Markdown ファイルとは
Markdown ファイルは、行の意味をレンダラーに伝えるわずかな記号付きのプレーンテキストです。ハッシュ2つで見出し、パイプで表、ハイフンとスペース2つでリスト項目になります。ファイル自体に書式はなく、どこで開いてもプレーンテキストです。Markdown プレビューはそのテキストをウェブサイトのようにレンダリングし、ソースではなく結果を見せます。このページの考え方はそれだけです。.md はそのまま、右側がそれがどう見えるかを示します。
オンラインビューアが役立つとき
オンライン Markdown ビューアを探す理由は、たいていは実務的です。リポジトリから README を取り、相対パスの画像・表・バッジが GitHub 以外でどう見えるか知りたい。あるいは README を書いていて、プッシュ前に表が崩れていないか確認したい。あるいは他人のマシンでドキュメントを読むだけで、何もインストールしたくない。このページを開けば三つとも解決します。入力するかファイルを開き、プレビューを読み、必要なものを取るだけ。プラグインも Node パッケージも、エディタ設定も不要です。
長い文書の目次・数式・PDF
長い文書には知っておくとよい点が二つあります。見出しは GitHub と同じアンカー id のクリック可能な目次にまとまるので、セクションリンクは想定どおり動き、五十ページの文書も一本のスクロールで終わりません。数式 —— ドル記号で囲んだもの —— は生の LaTeX ではなく LaTeX 風の数式 で正しく組版されます。下書きが終わったら、プレビューを文書として印刷し、ブラウザから PDF に保存できます。文字は選択でき、数式もそのまま残ります。
使う前に知っておきたい制限
頼る前に知っておくべき制限が二つあります。第一に、プレビューは GitHub Flavored Markdown に従い、見出し・リスト・表・タスクリスト・取り消し線・自動リンク・脚注・フェンス付きコードブロックをカバーしますが、完全な出版システムではなく、文書外ファイルへの参照スタイルリンクやカスタム HTML ページは対象外です。第二に、埋め込み HTML は実行されずテキストとして表示され、画像は指定した URL から読み込むため、ディスク上で .md の隣にある画像は、ホストするか data URI に埋め込まない限り表示されません。この二つの範囲内では、プレビューに見えるものが GitHub 互換レンダラーが同じファイルに対して出す結果です。
プライベート・高速・無料
100% ブラウザ内
レンダリングは端末上で行われます。Markdown はアップロードされず、コピーも保存されません。
登録不要
ページを開いてすぐ書けます。アカウントもログインも、インストールするプラグインもありません。
生 HTML は実行しない
埋め込み HTML はテキストとして表示され、文書がブラウザでスクリプトを実行することはありません。
GitHub 互換
GitHub Flavored Markdown 対応なので、プッシュ後の README の見え方を先に確認できます。
よくある質問
テキスト差分&比較Base64 エンコーダー&デコーダーJSON フォーマッター&バリデーターすべてのツールホームに戻る
このページでカバーできないレンダリング案件はありますか?
教えてください —— Mermaid 図、.pdf の直接ダウンロード、HTML ファイルへのエクスポート、プレビュー内の注釈が、いま最も多い要望です。