Markdownとは？軽量マークアップ言語の完全な解説
簡単な回答
Markdown は、単純な記号を使用してテキストの書式設定を行うプレーン テキストのマークアップ言語です。# は見出し、** は太字、* は斜体、- はリスト、[text](url) はリンクです。これはプレーン テキストとして読み取り可能で、HTML に変換できるように設計されています。無料の Markdown to HTML Converter を使用して、ブラウザで Markdown をレンダリングします。
導入
Markdown は、2004 年に John Gruber によって作成された軽量のマークアップ言語で、プレーン テキスト形式を使用して構造化ドキュメントを作成します。目標は読みやすさです。Markdown ソース テキストは、HTML タグのような視覚的な乱雑さを排除し、それが表すものと同じように見える必要があります。 Markdown は、GitHub 上の README ファイル、ドキュメント サイト、ブログ投稿、Reddit や Stack Overflow などのプラットフォーム上のコメント、Obsidian や Notion などのメモ作成アプリの標準です。 Web パブリッシング用にマークダウンは HTML に変換されます。
ステップバイステップ
-
基本的な構文を学ぶ
見出し: # H1、## H2、### H3。太字: **テキスト**。斜体: *テキスト*。リスト: - 項目または 1. 項目。リンク: [テキスト](url)。画像: 。コード: `inline` または ```block```。ブロック引用符: > 引用符。横罫線：---。
-
哲学を理解する
Markdown はプレーンテキストとして読めるように設計されています。ソースは最終的にレンダリングされた出力に近くなるはずです。**太字** は太字のように見え、# Heading は見出しのように見えます。これは、<strong>太字</strong>と <h1>見出し</h1> が視覚的に乱雑になっている HTML とは対照的です。
-
バリエーションを学ぶ
元の Markdown (Gruber の仕様) は最小限です。 CommonMark は、標準化され、明確に仕様が定められたバージョンです。 GitHub Flavored Markdown (GFM) は、テーブル、取り消し線、タスク リスト、自動リンクを追加します。 MDX を使用すると、React コンポーネントを Markdown に埋め込むことができます。ほとんどのツールは GFM をサポートしています。
-
マークダウンを HTML に変換する
Markdown は Web パブリッシング用に HTML に変換されます。 # Hello は <h1>Hello</h1> に、**太字** は<strong>太字</strong>になります。静的サイト ジェネレーター (Astro、Hugo、Jekyll) はビルド時に Markdown を変換します。即座に変換するには、Markdown to HTML コンバーターを使用してください。
例
見出しと段落
入力: # タイトル
一段落。
出力: <h1>Title</h1>
<p>A paragraph.</p>
太字と斜体
入力: **太字**および*斜体*
出力: <strong>bold</strong> and <em>italic</em>
リンクと画像
入力: [text](https://example.com) and 
出力: <a href="https://example.com">text</a> and <img src="image.png" alt="alt">
よくある問題
- 改行 — Markdown の 1 つの改行は、HTML では改行を作成しません。行末には 2 つのスペースを使用するか、段落区切りには 2 つの改行を使用します。
- ネストされたリスト — インデントが重要です。ネストされた項目には一貫して 2 つまたは 4 つのスペースを使用します。それらを混合すると、リスト構造が壊れる可能性があります。
- Raw HTML — ほとんどの Markdown パーサーは raw HTML を通過しますが、一部のパーサーはそれをサニタイズします。 HTML を直接埋め込む場合は、パーサーの動作を確認してください。
- さまざまなフレーバー - Original Markdown、CommonMark、GFM には微妙な違いがあります。ターゲット プラットフォームがどのフレーバーをサポートしているかを確認してください。
ヒント
- 記述とドキュメントには Markdown を使用します。HTML よりも読み書きがはるかに簡単です。
- GitHub Flavored Markdown (GFM) は最も一般的なバリアントで、テーブル、取り消し線、タスク リストが追加されます。
- ブログやドキュメント サイトのビルド時に Markdown で記述し、HTML に変換します。
- Markdown to HTML コンバーターを使用して、ブラウザーで瞬時に Markdown をレンダリングします。