実際の Markdown 公開チェック
書式の意外な違いを避けて Markdown を書き、確認し、公開する方法
README、文書、ノート向けの手順：移植性のある Markdown を書き、代表例を試し、最終レンダラーで確認します。
ツールを開くMarkdown はソースであり見た目の保証ではない
各プラットフォームはレンダラー、拡張、テーマ、HTML と改行規則を選びます。正しいプレビューでも CMS やメールでは変わることがあります。
明確なタイトル、順序ある見出し、実際のリスト、fenced code を使い、公開前に一節を対象で試します。
確認できる構造を作る
タイトル、目的、節、次の行動から始めます。見出しレベルは階層を表します。
説明的なリンクを使います。表は対象で確認し、幅が広ければリストを優先します。
誤読しやすい記法を試す
ネストしたリスト、パラメータ付きリンク、コード、引用、表、Unicode を確認します。
このプレビューは markdown-it を使い、生 HTML は無効、自動リンクと組版は有効、自動 `<br>` はありません。公開先は異なる場合があります。
HTML とエクスポートには限界がある
HTML エスケープだけでは任意のマークアップを安全化できません。信頼できない文字列を HTML やスクリプトの文脈へ直接挿入しないでください。
HTML ダウンロードはスタイルと資産なしの基本文書で、確認用です。
短いチェックリストで公開する
.md を保持し、狭い画面とリンクを確認し、最終レンダラーで下書きを試します。
処理はローカルでも、秘密、個人データ、保護されたコンテンツは慎重に扱います。
よくある質問
公開すると表示が変わるのはなぜ？
レンダラー、拡張、テーマ、公開先の規則が違うことがあります。
生 HTML は使えますか？
このプレビューでは使えません。他のシステムは異なる場合があります。
ダウンロード HTML は完成品ですか？
いいえ。スタイルや資産は含まれません。