Markdown: Markdown テキストのスタイル: 太字、斜体、その他
テキストのスタイルは文章の味付けです。正しく使用すれば、読者は重要なポイントを即座に見つけることができます。
1. 学ぶこと
- 太字と斜体の構文とそれらの組み合わせ方法
- 取り消し線の正しい使い方
- 水平罫線を作成する複数の方法
- マークダウンの改行ルール
- 特殊文字をエスケープする方法
2. テクニカルライターの実話
(1) 問題点: フォーマットの不一致が混乱を引き起こす
デビッドはチームの内部技術 Wiki の保守を担当していましたが、さまざまな人が書いたページの書式が一貫していないことに気付きました。太字に ** を使用している人もいれば、__ を使用している人もいました。斜体に * を使用するものと、_ を使用するものがあります。さらに悪いことに、太字であるべきキーワードを平文と混ぜて読みにくくしている人もいました。
(2) 解決策: 統一スタイルガイドライン
David は、チームの Markdown スタイル ガイドラインを作成しました。キーワードは **bold**、本のタイトルと専門用語は *italic*、非推奨のコンテンツは ~~strikethrough~~ に含まれます。ガイドラインが施行された後、Wiki の可読性スコアは 6.2 から 9.0 に跳ね上がりました。新しいチームメンバーは、フォーマットの方法を推測する必要がなくなりました。
3. テキストのスタイル設定の基本
Markdown のテキスト スタイル構文は直感的です。テキストを ペアのシンボルで囲みます。
graph LR
A[Text Styles] --> B[Bold ** **]
A --> C[Italic * *]
A --> D[Strikethrough ~~ ~~]
A --> E[Horizontal Rule ---]
B --> F[Emphasize keywords]
C --> G[Terms / book titles]
D --> H[Deprecated / removed content]
E --> I[Content separation]
| スタイル | 構文 | ショートカット(VSコード) | レンダリング |
|---|---|---|---|
| 太字 | **text** または __text__ |
Ctrl+B |
太字 |
| 斜体 | *text* または _text_ |
Ctrl+I |
斜体 |
| 太字 + 斜体 | ***text*** |
Ctrl+B + Ctrl+I |
太字斜体 |
| 取り消し線 | ~~text~~ |
Alt+Shift+S |
|
| 横罫 | --- または *** または ___ |
ショートカットはありません | 水平線 |
(1) 太字
テキストを二重アスタリスク ** または二重アンダースコア __ で囲みます。
MARKDOWN
This is an **important** concept.
**Note:** This section requires attention.
It's recommended to use asterisks `**` because they stand out more than underscores `__` in plain text.
💡 ヒント:
__ ではなく ** を使用してください。_ は単語内の斜体として誤解される可能性があるためです (例: some_func(param1, param2) のアンダースコア)。
(2) 斜体
テキストを単一のアスタリスク * または単一のアンダースコア _ で囲みます。
MARKDOWN
This is a classic book about *Design Patterns*.
In English, book titles are usually rendered in *italic*.
Note: _this text_ will also be displayed in italic.
⚠️ 注: イタリック体は、非ラテン文字ではそれほど目立ちませんが、英語のテキストやコード スニペットでは非常に役立ちます。
▶ 例: 太字と斜体の組み合わせ
MARKDOWN
**Important:** This feature was deprecated in *v2.0*. Please use the ***new API*** instead.
4. 取り消し線と横罫線
(1) 取り消し線
取り消し線は、テキストが削除または非推奨であることを示すために 2 つのチルダ ~~ を使用します。
MARKDOWN
Original price: ~~$299~~ **$199** (limited-time offer)
The following feature has been deprecated: ~~legacy API~~ — please use the new version.
~~This content is outdated and has been updated.~~
💡 ヒント: 取り消し線は通常、価格の変更、バージョンの更新、または古いコンテンツを示すために使用されます。使いすぎると文書が乱雑に見えてしまいますので注意してください。
(2) 横罫線
横罫線は、3 つ以上の -、*、または _ で作成されます。
MARKDOWN
# Part One
This is the content of part one.
---
# Part Two
This is the content of part two.
---
---
Multiple horizontal rule notations all produce the same result.
⚠️ 注: 水平罫線の上下に空白行を残しておくと、(上の行にテキストがある場合) Settext 見出しとして誤解される可能性があります。
▶ 例: さまざまなコンテキストでの水平ルールの使用
MARKDOWN
# Project Documentation
## Installation Guide
...
---
## Usage Instructions
...
---
## API Reference
...
💡 ヒント: 横罫線は主要なセクションを区切るのに最適ですが、単一のテキスト ブロック内で使用することは避けてください。 1 つの記事につき 3 ～ 5 つのルールで十分です。
5. 改行と段落
Markdown の改行ルールは Word とは異なります。注意してください。
| アクション | 構文 | レンダリング |
|---|---|---|
| 新しい段落 | 行間の空白行 | 新しい段落 (間隔を広く) |
| 改行（ソフトブレーク） | 行末にスペースを 2 つ入力し、「 | 」と入力します。改行 (間隔を狭く) |
| 休憩なし | 連続テキスト | 同じ段落に自動結合 |
MARKDOWN
This is the first line,
this is the second line (two trailing spaces).
This is a new paragraph (blank line above).
This is text within the same paragraph —
note that this line break won't take effect (no trailing spaces).
💡 ヒント: ほとんどの Markdown エディター (Typora など) では末尾のスペースは必要ありません。Enter キーを押すと改行が直接挿入されます。ただし、GitHub および厳密な CommonMark パーサーでは、末尾に 2 つのスペースを置くのが標準的なアプローチです。
▶ 例: 改行効果の比較
MARKDOWN
No trailing spaces
Line break not applied (same paragraph)
Two trailing spaces··
Line break applied.
Blank line =
new paragraph.
6. 特殊文字のエスケープ
Markdown シンボルを (有効にするのではなく) リテラル文字として表示したい場合は、バックスラッシュでエスケープします \:
| 生のテキスト | 逃げた | 表示される |
|---|---|---|
**not bold** |
\*\*not bold\*\* |
太字ではありません (アスタリスクは文字通りに示されています) |
# not a heading |
\# not a heading |
# 見出しではありません |
--- not a rule |
\-\-\- not a rule |
--- 規則ではありません |
MARKDOWN
Common escaping scenarios:
- Display an asterisk: \*this is not italic\*
- Display a hash sign: \# this is not a heading
- Display a backtick: \` \` (use double backticks)
- Display a backslash itself: \\\\
💡 ヒント: これは経験則です。Markdown で特別な意味を持つ記号のみをエスケープします。通常の句読点 (カンマ、ピリオド、括弧) はエスケープする必要がありません。
7. 完全な例: 製品発表の書式設定
TEXT
📖 参照専用
# Version Update: v3.0 Officially Released
We are excited to announce that Product Pro v3.0 is live today!
New features:
1. Dark Mode — easier on the eyes, longer battery life
2. Smart Recommendations — tailored to your usage habits
3. Legacy dashboard → brand-new interactive dashboard
Install command:
npm install product-pro@latest
Note: v2.x users, please refer to the v3 migration guide
期待される結果: 重要な情報を強調表示する太字、非推奨の機能の取り消し線、セクションを区切る水平罫線を備えた、豊富な形式の製品発表。
❓ よくある質問
Q 太字と斜体ではどちらが強調に適していますか?
A 太字はキーワードや重要な情報を強調する場合に使用します。斜体は書籍のタイトル、専門用語、および微妙な区別を表します。すべてを太字にしないでください。それは何も強調しないのと同じです。
Q 水平罫線が機能しないのはなぜですか?
A 一般的な原因: ① 上の行が空白行で区切られていません (パーサーはそれを Settext 見出しとして扱います)。ダッシュの代わりにスペースを使用しました。
--- はコード ブロック内にあります。Q 改行が機能しない場合はどうすればよいですか?
A 行の末尾にスペースを 2 つ追加し、Enter キーを押します。または、空白行を挿入して新しい段落を開始します。 Typora のようなエディタでは、Shift+Enter でソフト改行が挿入されます。
Q 異なるスクリプト文字の間にスペースを追加する必要がありますか?
A はい、推奨されます。
This is a Markdown tutorial は This is aMarkdown tutorial よりも読みやすくなります。これは Markdown 構文の要件ではなく、表記規則です。Q アスタリスクとアンダースコアの両方を使用できますか?
A はい、しかし、それらを混合することはお勧めできません。単一の文書では、スタイルの一貫性を保つために、太字には二重アスタリスク、斜体には単一アスタリスクを使用してください。
📖 まとめ
- 太字は
**、斜体は*、取り消し線は~~ -、*、または_を3つ以上含む横罫- 空白行を含む新しい段落。段落内で改行し、末尾に 2 つのスペースを入れる
\で特殊文字をエスケープします- 自分のスタイルに一貫性を保ちます — 異なる構文を混合しないでください
📝 練習問題
-
初心者: 太字 (名前/スキル)、斜体 (座右の銘)、取り消し線 (古い情報)、および横罫線を含む短い自己紹介を Markdown で作成します。
-
中級: 数行のテキストを書いて、末尾のダブルスペース改行とスペースなし改行の違いを確認します。次に、
**シンボルを\でエスケープし、太字ではなく文字通りのアスタリスクとして表示されます。 -
課題: 少なくとも 2 つの新機能 (太字)、1 つの非推奨機能 (取り消し線)、1 つの重要な注記 (太字 + 斜体)、および 3 つの横罫線を含む製品変更ログを作成します。書式が正しく、階層が明確であることを確認してください。
