Markdown の書き方の記事
見出し、改行、表、チェックボックス、リンク。Markdown の書き方を、標準の仕様(CommonMark・GFM)にもとづいて、1 つずつ例つきで短く解説します。ChatGPT などの AI の回答をきれいに読む方法も。
Markdown のきほん
Markdown とは何か、書き方の一覧、AI の回答に出る記号の意味。
Markdown の書き方一覧(チートシート)
Markdown の書き方を一覧にしました。見出しは #、太字は **、箇条書きは -、表は |、コードは ```。標準(CommonMark)の書き方、GitHub の拡張(GFM)、標準でない書き方を分けて、そのままコピーできる例つきでまとめます。
読むChatGPT の回答をコピーすると ** や # が出るのはなぜ? きれいに読む方法
ChatGPT などの AI の回答に出る ** や # は、Markdown という書き方の記号です。** で囲んだところが太字、# が見出し。チャットの画面では整えて表示されますが、記号のまま貼ると読みにくくなります。Markdown に対応したアプリに貼るか、記号なしで答えてもらいます。
読むMarkdown(マークダウン)とは? 記号で書式をつける書き方
Markdown は、# や ** などの記号で見出しや太字を表す、文章の書き方です。2004 年に John Gruber が公開し、いまは CommonMark が標準の仕様。ChatGPT などの AI の回答も Markdown で書かれています。
読む
文の書き方
見出し、太字、改行、箇条書き、チェックボックス。
Markdown で改行されないのはなぜ? 改行のしかた
Markdown では、Enter で 1 回改行しただけでは、表示で前の行とつながります。改行するには行の終わりに空白 2 つ、バックスラッシュ、または <br> を書きます。段落を分けたいときは空行を入れます。
読むMarkdown で太字にならないのはなぜ? 太字・斜体・打ち消し線の書き方
Markdown の太字は **太字** と書きます。日本語で太字にならないのは、多くの場合「」や。などの記号のすぐ外側に ** を置いたとき。CommonMark の決まりで、記号と文字の境目では ** が働かないことがあるためです。直し方と、斜体・打ち消し線の書き方も。
読むMarkdown の見出しの書き方は? # の数と、見出しへのリンク
Markdown の見出しは、行の頭に # を 1〜6 個書き、空白を 1 つあけて文字を書きます。# が 1 個なら大見出し、増えるほど小さな見出しに。# のあとの空白を忘れると見出しになりません。見出しへのページ内リンクの書き方も。
読むMarkdown の箇条書きと番号付きリストの書き方は? 入れ子にするには
Markdown の箇条書きは行の頭に「- 」、番号付きリストは「1. 」と書きます。入れ子にするには、子の項目を、親の項目の文の頭の位置まで字下げします(「- 」なら空白 2 つ、「1. 」なら 3 つ)。番号は最初の数字だけが使われます。
読むMarkdown でチェックボックスを書くには? チェックできないのはなぜ?
Markdown のチェックボックスは「- [ ] やること」、チェック済みは「- [x] やること」と書きます。GitHub の拡張(GFM)の書き方で、表示を押してチェックできるかはアプリ次第。仕様は押し方を決めておらず、押せない表示も多くあります。
読む
表・リンク・画像・コード
表、リンク、画像、コードブロック。標準でない書き方も見分けます。
Markdown で表を書くには? セル内の改行や結合はできる?
Markdown の表は、| で列を区切り、見出しの行の下に | --- | --- | を書きます。GitHub の拡張(GFM)の書き方です。セルの中の改行と、セルの結合の書き方は仕様にありません。改行は HTML の <br> で代わりにすることが多く、結合は HTML の表で書きます。
読むMarkdown でリンクを書くには? ページ内リンクや新しいタブは?
Markdown のリンクは [表示する文字](URL) と書きます。URL をそのまま <> で囲んでもリンクになります。見出しへのページ内リンクは (#名前)、別のファイルは相対パス。新しいタブで開く書き方は、Markdown にはありません。
読むMarkdown で画像を貼るには? サイズの指定や横並びはできる?
Markdown の画像は  と書きます。リンクの頭に ! をつけた形です。標準の Markdown に画像のサイズを指定する書き方はなく、HTML が使えるところでは <img> の width で大きさを決めます。
読むMarkdown のコードブロックの書き方は? 言語の指定とバッククォートの入れ方
Markdown のコードブロックは、バッククォート 3 つ(```)の行で前後を囲みます。始めの ``` のすぐあとに js や python などの言語名を書くと、対応したアプリで色分けされます。中に ``` を入れたいときは、外側を 4 つにします。
読む