MD ViewerMD Viewer

100% プライベート — すべてブラウザ内で処理

マークダウン 取り消し線 — GFM構文とライブデモ

二重チルダでテキストを囲むと、マークダウン 取り消し線が引かれます。デモを編集して線が即座に現れるのを見て、構文をコピーできます。

MD Viewer チーム

例
Markdownソース
プレビュー

This sentence shows removed text next to normal text.

マークダウン 取り消し線は、削除はしていないが打ち消した文本を見せるためのものです。変更された価格、完了したタスク、文脈のために残す古い主張。構文はテキストを二重のチルダで囲むだけで、上のプレイグラウンドがライブでレンダリングします。チルダの間の言葉を編集すると、マークダウン 取り消し線のプレビューがキーを打つたびに更新され、線がどこで始まりどこで終わるか正確に分かります。

このページで最も重要な事実が1つあります。マークダウン 取り消し線は古典的なMarkdownではありません。GitHub Flavored Markdown(GFM)、つまり表やタスクリストも加えた広く採用された拡張セットからのものです。GitHub、GitLab、Bitbucket、ほとんどの現代のドキュメントプラットフォーム、そしてこのサイトのエンジンが対応します。ただし厳格なCommonMarkプロセッサはチルダ2つをそのまま表示します。ここで書くマークダウン 取り消し線は、GFMの通じるすべての場所で機能します。

この記法は意味を運びます。打ち消されたテキストは「置き換えられた」と読まれます。変更履歴は古いバージョン番号を打ち消して隣に新しい番号を書き、議事録は解決した項目を打ち消し、価格表は元の金額を打ち消します。上のタスクリストの例は、マークダウン 取り消し線を有名にした組み合わせ——状態にはチェックボックス、履歴には打ち消し線——を見せます。

マークダウン 取り消し線の構文リファレンス

入力結果
~~テキスト~~横線が引かれたテキスト
~~旧~~ 新旧い値が打ち消され、新しい値が隣に
**~~両方~~**太字と打ち消し線の組み合わせ
~~複数語のフレーズ~~内側のすべての語に線が掛かる
~チルダ1つ~打ち消されない。GFMはちょうど2つ必要

マークダウン 取り消し線の書き方

  1. 1

    打ち消すテキストを決める

    マークダウン 取り消し線は単語、フレーズ、行全体で機能します。マーカーの間すべてに線が引かれるため、意図に合う境界を選んでください。

  2. 2

    二重チルダで囲む

    テキストの直前に~~、直後に~~を入力します。チルダと語の間にスペースを入れません。上のプレイガウンドのプレビューが、解析された瞬間を教えてくれます。

  3. 3

    注意して組み合わせる

    打ち消し線は他の強調と合成します。**~~太字の打ち消し~~**は両方を表示します。順序はほぼ問題になりませんが、マーカーの対が崩れると問題になります。行の半分だけ線が入ったらプレビューを確認してください。

  4. 4

    構文をコピー

    プレイグラウンドの「Markdownをコピー」で、チルダ込みの正確なマークダウン 取り消し線のソースを取得できます。README、issue、メッセージにそのまま使えます。

マークダウン 取り消し線がGFMに属する理由

元祖Markdownには打ち消し線がありませんでした。作者は削除をHTMLのdelタグに属する提示の考えだと見なしていたからです。コミュニティは別の意見でした。GitHubは2014年にGFMの一部として~~text~~を出荷し、issue、プルリクエスト、wiki、READMEでの圧倒的な普及によって、マークダウン 取り消し線は事実上の標準になりました。今日、この構文はCommonMarkへのGFM拡張として仕様化され、表に対応するほぼすべてのレンダラーが対応しています。

互換性の裏面も現実です。厳格なCommonMark環境では、~~下書き~~は文字どおり表示されます。害はありませんが見苦しい。そういうレンダラーを生き延びる必要がある文書では、代わりにHTMLのdelタグ(HTMLが許される場所での意味的な削除。HTMLホワイトリストの挙動はマークダウン 下線のページで説明します)を使うか、テキストを削除するかです。このサイトのすべてのツールはGFMをレンダリングするため、ここで試したマークダウン 取り消し線はGitHubの挙動と一致します。

最後に運用の目安を。打ち消し線は変更の履歴を示す道具であって、注目を集める装飾ではありません。文書1つにつき1〜2箇所なら情報として働き、10箇所なら戦場の跡に見えます。定期的なコンテンツレビューで古いマークダウン 取り消し線を刈り込みましょう。

マークダウン 取り消し線の間違い

~チルダ1つ~

~~チルダ2つ~~

両側に1つずつのチルダではマークダウン 取り消し線は作れず、チルダが見えたまま表示されます。GFMは対を要求します。

~~ 離した ~~

~~密着~~

チルダの内側のスペースは、一部のレンダラーで解析を弱めたり壊したりします。マークダウン 取り消し線のマーカーはテキストに密着させて。

~~閉じていない打ち消し

~~閉じた~~

対にならない開きマーカーは何も打ち消しません。チルダがそのまま表示されます。常に2つのマーカーを。プレビューが違いを即座に示します。

打ち消されたテキストはまだテキスト

スクリーンリーダーはマークダウン 取り消し線を削除済みと読み上げることもありますが、検索エンジンは語を索引し、コピーは語を保ちます。線の裏に秘密を隠さないでください。本当に消すべきテキストは削除してください。

よくある質問

出典と仕様引用

“Strikethrough spans are delimited by a double tilde (~~).”
GitHub Flavored Markdown Spec
“GitHub Flavored Markdown, often shortened as GFM, is a strict superset of CommonMark.”
GitHub Flavored Markdown Spec

関連するMarkdownツール