MD ViewerMD Viewer

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

マークダウン 下線 — HTMLタグで安全に表示

標準のMarkdownに下線マーカーはありません。HTMLのuタグを使うマークダウン 下線の実践レシピを、ライブプレビューとコピー可能な例で解説します。

MD Viewer チーム

例
Markdownソース
プレビュー

Normal text and underlined text in one line.

マークダウン 下線は、言語の穴を露呈する要望です。Markdownに下線のネイティブ構文は存在しません。アスタリスクは斜体、二重アスタリスクは太字、二重チルダは打ち消し線を与えますが、どの文字の対も下線を引きません。HTMLが許される場所で機能するマークダウン 下線の方法がuタグです。<u>下線付きテキスト</u>。上のプレイグラウンドがそれを安全にライブレンダリングします。左にソース、右に結果です。

マークダウン 下線がHTMLに依存するため、2つの規則が続きます。第一に、レンダラーがインラインHTMLを許可していなければなりません。GitHub、GitLab、ほとんどのドキュメントサイト、そしてこのページは許可します。厳格なCommonMarkサンドボックスや一部のwikiはしません。第二に、タグはサニタイズされる必要があります。このサイトはuタグをホワイトリストに加え、ユーザーマークアップからすべてのイベントハンドラと危険な属性を除去するため、ここでマークダウン 下線を試してもリスクはありません。

20年の習慣からの忠告を1つ。ウェブでは下線付きのテキストはリンクとして読まれます。マークダウン 下線は、本当の意味を持つ少数の場所——中国語の固有名詞、印刷物のフォームラベル、伝統的な文書スタイル——のために取っておき、強調には太字か斜体を選んでください。互換性の詳細はマークダウン アンダーラインのページが扱い、このページは構文の実践デモです。

マークダウン 下線の構文リファレンス

入力結果
<u>テキスト</u>uタグによる本物のマークダウン 下線
**<u>太字の下線</u>**太字と下線の組み合わせ
_テキスト_斜体。下線ではない頻繁な誤解
__テキスト__太字。二重アンダースコアは強調
<ins>テキスト</ins>挿入の意味。多くのレンダラーで下線表示

マークダウン 下線の引き方

  1. 1

    HTMLが許可されているか確認

    マークダウン 下線には、インラインHTMLを受け付けるレンダラーが必要です。本番のドキュメントで頼る前に、上のプレイグラウンドか、対象プラットフォームのスクラッチファイルで試してください。

  2. 2

    テキストをuタグで囲む

    語の前に<u>、後に</u>と書きます。下線は囲まれた範囲にだけ掛かり、ライブプレビューが編集中に境界を見せてくれます。

  3. 3

    他の強調と組み合わせる

    uタグはMarkdownの強調と合成します。**<u>太字の下線</u>**は両方を表示します。タグの対応が崩れると段落の残りが下線を継承するため、釣り合わせを保ってください。

  4. 4

    コピーして他所で確認

    「Markdownをコピー」で正確なソースを取得します。READMEやissueに貼り、マークダウン 下線が表示されるか確認してください。互換性のページが安全なプラットフォームを列挙しています。

マークダウン 下線のネイティブ構文がない理由

John Gruberの元祖Markdownが下線を意図的に省いたのは、ウェブ固有の理由からでした。ウェブページでは下線はハイパーリンクを意味します。下線付きテキストを追加したら、メディアで最も重要な手がかりと衝突し、読者は下線の語をクリックして何も見つからないことになります。だからMarkdownは強調、強い強調、コードとともに生まれ、マークダウン 下線は今日までHTMLからの輸入品のままです。

この穴は、書く文化によって違う顔を見せます。中国語の組版では下線は固有名詞を示し、マークダウン 下線の質問が絶えないほど一般的です。東アジアの文書では、西洋が斜体を使う箇所——書名——に短い<u>スパン</u>を当てるのが慣用的です。法務や学術の文書では印刷時代のスタイルとして下線が生き残っています。これらが正当な用途です。ウェブでの単純な強調には太字と斜体が、誰も混乱させずに意味を運びます。マークダウン 下線が正しいのは、線そのものがメッセージのときです。

実装面では、このページのエンジンはuタグをホワイトリスト登録されサニタイズされた要素として扱います。onclickハンドラ、スタイル属性、スクリプトは表示前に除去され、本物のマークダウン 下線としてレンダリングされます。公開ツールとして正しい取引です。タイポグラフィを得て、XSSの面は失う。

マークダウン 下線の間違い

__下線__

<u>下線</u>

二重アンダースコアは太字であって下線ではありません。マークダウン 下線に文字ベースの構文はなく、uタグが必要です。

<u onclick=…>

<u>裸のタグ</u>

onclickのような属性はこのページのサニタイザーに除去されます。マークダウン 下線に必要なのは裸のタグだけで、綺麗なマークアップは表示され、危険なマークアップはされません。

あらゆる強調に下線

強調には太字か斜体

ウェブでは下線付きテキストはリンクに読まれます。マークダウン 下線は固有名詞と印刷物風の文書のためにとっておき、強調には太字か斜体を選んでください。

下線とPDFエクスポート

マークダウン PDF 変換のページはマークダウン 下線を、本当の下線付きPDFテキストに変換します。下線とリンクが混ざった文書では、両方とも生き残ります。リンクは青くクリック可能のまま、uスパンは落ち着いた下線付きで。

よくある質問

出典と仕様引用

“The <u> HTML element represents a span of inline text which should be rendered in such a way as to indicate that it has a non-textual annotation.”
MDN Web Docs — <u>: The Unarticulated Annotation element
“Markdown treats asterisks (*) and underscores (_) as indicators of emphasis.”
John Gruber, "Markdown: Syntax" (Daring Fireball, 2004)

関連するMarkdownツール