Web の世界では、情報をどのように表示するかが重要な要素となります。
文字の装飾やレイアウトなど、視覚的な表現はメッセージを効果的に伝えるための重要な手段です。そのため、HTMLなどの Markup 言語が用いられてきました。しかし、これらの言語は学習が難しく、また、見た目と構造が一致しないという欠点もあります。
この問題を解決するために考案されたのが、Markdown 記法です。
マークダウン記法は、視覚的な情報の表現を簡単に行うことができる一方で、その構造が直感的であるため、覚えやすいというメリットがあります。この記事では、Markdown 記法の基本について紹介します。
Markdown記法の基本
ヘッダー(見出し)
文書に構造をつけるための最も基本的な要素がヘッダー(見出し)です。
マークダウンでは、「#」を使用して見出しを作成します。
「#」の数によって、見出しのレベル(H1〜H6まで)を表現します。HTMLの<h1>から<h6>タグに対応します。
# H1
## H2
### H3
#### H4
##### H5
###### H6
このように、Markdown では、一貫性を保つために見出しのレベルを簡単に変更することができます。また、視覚的にも見出しのレベルをすぐに理解することができます。
テキストスタイリング
テキストの装飾は、情報を強調するために重要なツールです。
マークダウンでは、テキストを強調したい場合、「*」または「_」を使用します。
アスタリスク1つで囲むと斜体、2つで囲むと太字、3つで囲むと太字斜体になります。
*斜体*
**太字**
***太字斜体***
この機能は、特定の情報を強調したり、文章内で特定のテキストをハイライトしたりするときに非常に便利です。
リスト
リストは、一連の関連情報を整理し、読みやすく表示するための重要なツールです。
マークダウンでは、リストは「*」、「+」、「-」のいずれかを使用して作成します。
これらの記号に続けてスペースを1つ開けると、項目が作成されます。番号付きのリストを作成するには、数字とピリオド「.」に続いてスペース1つ開けます。
- 項目1
- 項目2
- 項目3
1. 項目1
2. 項目2
3. 項目3
これらのリストは、文書内でのステップの説明や項目のリスト化など、多くの用途に使用することができます。
リンクと画像
Web 文書では、他のページへのリンクや画像の挿入は一般的な要素です。
Markdown では、これらも非常に簡単に行うことができます。
リンクは、角括弧「[]」にリンクのテキストを、その直後の丸括弧「()」にURLを記述します。
[Gift by Gifted](https://gift-by-gifted.com/)
画像も似た記法を使用しますが、最初にエクスクラメーションマーク!を追加します。丸括弧内に画像のURL、角括弧内に画像の代替テキスト(altテキスト)を記述します。
![Gift by Giftedロゴ](https://gift-by-gifted.com/logo.png)
この記法により、文書内で簡単にリンクや画像を追加することができます。
ブロッククォートとコードブロック
他のテキストからの引用や、コードの表示は、特定の情報を強調するための有効な手段です。
マークダウンでは、これらも簡単に行うことができます。「>」を使用してブロッククォートを作成します。
> これはブロッククォートです。
バックティック「`」を使用してコードを記述します。インラインコードは1つのバックティックで囲み、コードブロックは3つのバックティックで囲みます。
`インラインコード`
```コードブロック```
これにより、ブログポストやチュートリアルなどで、他の資料からの引用やコードスニペットを簡単に表示することができます。
テーブル
情報を整理するためにテーブルを使用することもあります。マークダウンでは、パイプ「|」とハイフン「-」を使用してテーブルを作成します。1行目はヘッダー、2行目は列の区切り、3行目以降がデータ行です。
| 列1 | 列2 | 列3 |
| ---- | ---- | ---- |
| データ1 | データ2 | データ3 |
これにより、データを整理して視覚的に表示することが可能になります。
水平線
テキストのセクションを分割するために水平線を使用することがあります。
マークダウンでは、3つ以上のハイフン(—)、アスタリスク「***」、アンダースコア「___」を使用して水平線を作成します。
---
このように、Markdown では、文書の構造を視覚的に明確にするための多くの記述法が提供されています。
まとめ
以上が、Markdown 記法の基本的な部分です。
簡単に覚えられ、視覚的にも分かりやすいマークダウン記法は、Web 上で情報を効果的に伝えるための強力な記述法です。その柔軟性と自由度は、あなたのニーズに応じた最適なドキュメントを作成するのに役立つでしょう。
HTMLのように複雑な Markup 言語を学ぶ必要がなく、読みやすいプレーンテキストで構造的な文章を作成できるため、さまざまな分野で利用されています。
まだ使われてない方は、一度 Markdown 記法を使ってみてください。