Markdown記法とは？

Markdownとは、テキストを簡単に整形するための軽量なマークアップ言語で、もともとはエンジニア達がメモを書いたりするときに使われていたものです。主にウェブページやドキュメントで使われ、プレーンテキストで記述可能で、HTMLに変換できます。最近ではAIの複雑なプロンプトを作成するのに必須となってきています。以下では、主なルール、記号、その意味を詳しく説明します。

 
 まず、見出しのルールです。見出しはテキストの階層構造を示すために使われます。記号はシャープ(#)を使い、#の数でレベルを表します。例えば、# 見出し1 は一番大きな見出しを意味し、HTMLの<h1>タグに相当します。## 見出し2 は中くらいの見出しで<h2>、最大で###### 見出し6 まで可能です。行頭に#を置き、スペースを入れてテキストを書きます。これにより、文書の構造が明確になります。

次に、強調の記号です。太字にするには、アスタリスク(**)またはアンダースコア(__)でテキストを囲みます。例えば、**太字** や __太字__ は強い強調を意味し、HTMLの<strong>タグになります。斜体は単一のアスタリスク(*)またはアンダースコア(_)で囲み、*斜体* や _斜体_ は<em>タグ相当です。これらを組み合わせることもでき、***太字斜体*** で両方を適用します。強調は重要な部分を目立たせるために使われます。

 

リストの作成についてです。箇点リスト(順不同リスト)は箇条書きと理解してください。ハイフン(-)、アスタリスク(*)、またはプラス(+)で行頭に置き、スペースを入れて項目を書きます。例えば、- 項目1 は<ul>タグのリストアイテムになります。番号付きリスト(順序リスト)は、数字とピリオド(1.)で行頭に置き、1. 項目1 のようにします。番号は自動的に連番になるので、実際の数字は1から始めなくても大丈夫です。リストはサブリストも可能で、インデント(スペース4つ)を使ってネストします。これにより、情報を整理して提示できます。

 

リンクと画像の挿入です。リンクは角括弧[]でテキストを囲み、続けて括弧()でURLを指定します。例えば、[Google](https://google.com) は<a>タグのハイパーリンクになります。画像は感嘆符!を[]の前に付け、 で<img>タグ相当です。代替テキストは画像が表示されない場合の説明として機能します。これらは文書に外部リソースを埋め込むために使われます。

 

コードの表示です。ここでいうコードとは、プログラム言語で書いたプログラムのことです。インラインコード（1行の中に書いた短いプログラム）はバッククォート(`)で囲み、`code` のようにします。複数行のコードブロックは、3つのバッククォート(```)で囲み、言語名を指定してシンタックスハイライトも可能です。例えば、`````` は<pre><code>タグになります。インデント(スペース4つ)でもコードブロック（プログラム中で使われる段落）を作れます。これにより、プログラミングコードを整形して共有できます。

 

引用の記号は大なり記号(>)です。行頭に>を置き、> 引用文 とすると<blockquote>タグになります。複数行の引用は各行に>を付け、ネストも可能です。引用は他者の言葉や参考文献を示すために有効です。

 

水平線は3つ以上のハイフン(---)、アスタリスク(***)、またはアンダースコア(___)を単独の行に置き、<hr>タグの区切り線を作成します。これでセクションを分離します。

テーブルのルールです。テーブルとは「表」のことです。パイプ(|)で列を区切り、ハイフンでヘッダーと本文を分けます。例えば、
| ヘッダ1 | ヘッダ2 |\n|
--------|--------|\n
| データ1 | データ2 |
のように記述します。これはhtmlに変換されると<table>タグになります。列の整列は:を使って左寄せ(:---)、中央寄せ(:---:)、右寄せ(---:)を指定できます。テーブルはデータを表形式で整理するのに適しています。

その他のルールとして、

改行は行末にスペース2つを置くか、空行を挿入します。

エスケープはバックスラッシュ(\)で特殊記号を無効化します。例えば、\* は*として表示されます。Markdownのバリエーション(例:GitHub Flavored Markdown)ではタスクリスト(- [x] 完了)や絵文字(:smile:)も追加されますが、基本は上記です。

これらの記号はシンプルで、覚えやすく、テキストエディタで簡単に書けます。Markdownはブログ、READMEファイル、ノート取りに広く使われ、ルールを守ることで一貫した出力が得られます。詳細は公式ドキュメントを参照してください。

以上の文章は「Markdown記法のルールと記号とその意味を詳しく説明する文章をMarkdown記法を用いずに1500文字程度で書いてください。」という指示をしてperplexityで作成したものを私が少し手を入れてわかりやすく加工しました。

 

Markdown記法で書かれた文章をそのままこのブログに貼り付けると少し読みにくくなるので、今回は「Markdown記法を使わずに〜文章で」という指示文をつけました。前回の記事より少し読みやすくなっていると思います。