1Tools

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 は実行されないため、文書がブラウザでスクリプトを走らせることはありません。レンダリングは端末上で完結:アップロードなし、アカウントなし、サーバーにファイルのコピーも残りません。

使い方

  1. 01

    エディタに Markdown を入れます。入力、貼り付け、ディスクから .md を選ぶ、ページにドロップ、のいずれかで。プレビューの動きだけ見たい場合は、サンプル README が読み込まれます。

  2. 02

    右側でレンダリング結果を読みます。入力中にプレビューが更新され、見出し・表・リスト・リンク・数式・コードブロックが公開時と同じ見え方になります。仕切りをドラッグして左右の幅を変えるか、スマホでは「編集 / プレビュー」タブを切り替えます。

  3. 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 ファイルへのエクスポート、プレビュー内の注釈が、いま最も多い要望です。

フィードバックを送る