マークダウン記法とは？ 初めての方向けに基礎を試してみた
はじめに
はじめまして、クラスメソッドオペレーションズ株式会社 育成推進チームの坂口です。
2026 年に新卒入社し、現在は研修中の身です。
研修の中で初めてマークダウン（Markdown）という言葉に出会い、「なんだこれ！」と気になったのがこの記事を書くきっかけです。
ブログや社内ドキュメントを書く上で最低限の知識は身につけておきたいと思い、自学も兼ねて調べながらまとめてみました。
同じく「Markdown って何？」「なんとなく気になってる」という方の参考になれば幸いです。
・Markdown とは？
ブログなどの記事を書き始める際に、必ずと言っていいほど避けては通れない Markdown。
Daring Fireball
(https://daringfireball.net/projects/markdown/syntax)
（Markdown の作者 John Gruber さんの公式サイト）によると
「Markdown is a text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid HTML.」
（訳）Markdown は、Web ライター向けのテキストから HTML への変換ツールです。Markdown を使用すると、読みやすく書きやすいプレーンテキスト形式で文章を作成し、それを構造的に有効な HTML に変換できます。
……とのことです。
文章の見た目を簡単に変更できる、HTML を使わなくてもリンクを埋め込める、など様々な便利なことができます。
ただ、何から手をつけていいかわからない……！
今回はそんな Markdown について、自学も兼ねて調べながら実践していこうと思います。
わかりやすいところから触れてみる
早速タイトルに Headings（見出し）と呼ばれるものを適用しました。
やり方は、装飾したい文字列の先頭に「# 」を挿入するだけ。
入力例
# 見出しにしてみる
↓（実際に適用すると…）
見出しにしてみる
とても簡単です。
「#」と見出しにしたい文字列との間には「 （半角スペース）」を入れてあげないと認識してくれないので、忘れずにつけてあげましょう。
Markdown は基本的に記号を行頭に挿入したり記号で囲ったりという操作で、文の見た目を彩ることができます！
実はブログ等に限らず、Markdown は Discord のチャットのようなところでも利用できる場合があります。
身近なアプリケーションで Markdown が使えるところを探してみましょう！
記述例
よく使う Markdown 記法を実際に試してみましょう。
文字の強調
まずは文章の中で一番よく使う「文字の強調」から。
例えば、文字を太字にしたい時は、対象の文字を「**（アスタリスク 2 つ）」で囲みます。
入力例
**太字にしたい！！！**
↓（実際に適用すると…）
太字にしたい！！！
打ち消し線
「~~（チルダ 2 つ）」で囲むことで打ち消し線を引くことができます。
これも Discord などで「ちょっとここ強調したいな」という時や、冗談っぽく発言を取り消したい時などにサッと使えるので面白い便利ですよ！
箇条書き（リスト）
文章が長くなってくると、箇条書きにしてスッキリ見せたいことってありますよね。
Markdown なら行の先頭に「-（ハイフン）」と「半角スペース」を入れるだけで、綺麗なリストになります。
入力例
- りんご
- みかん
- ばなな
↓（実際に適用すると…）
- りんご
- みかん
- ばなな
いちいちマウスで「箇条書きボタン」を押さなくても、キーボードの操作だけでリスト化できるので、執筆スピードがグッと上がります。
インラインリンク
「参考記事はこちら！→ https://〜〜〜〜〜〜〜〜〜〜〜」
URL をそのまま貼り付けると長くて見栄えが悪くなってしまうこと、ありますよねぇ…。
そんな時は、[表示したいテキスト](URL) という書き方をします。
入力例
[Google はこちら](https://www.google.com/)
↓（実際に適用すると…）
HTML を直接書かずとも、たったこれだけでスッキリとしたリンクを作ることができちゃいます。
href 属性を使った <a> タグよりも、ずっとシンプルに書けますね！
引用
他のサイトや文献から文章を引用したい時は「>（大なり記号）」と「半角スペース」を使います。
入力例
> Markdown は、シンプルな記号（# や * など）を使って〜
↓（実際に適用すると…）
Markdown は、シンプルな記号（# や * など）を使って〜
どこからが自分の文章で、どこからが引用なのかが視覚的にハッキリするので、読者にとって親切な記事になります。
コードブロック
プログラムのコードや設定ファイルの内容を記載する際は、バッククォート 3 つ（```）で囲むことでコードブロックとして表示できます。
入力例
```
print("Hello, World!")
```
↓（実際に適用すると…）
print("Hello, World!")
テーブル（表）
情報を整理して比較したい時は、テーブルが便利です。
|（パイプ）と -（ハイフン）を組み合わせて作成します。
入力例
| 記法 | 用途 |
| --- | --- |
| # | 見出し |
| ** | 太字 |
| > | 引用 |
| ``` | コードブロック |
↓これを実際に適用すると↓
| 記法 | 用途 |
|---|---|
| # | 見出し |
| ** | 太字 |
| > | 引用 |
| ``` | コードブロック |
この記事で紹介した記法をまとめるのにも使えますね！
メッセージ
読者に特に伝えたいポイントや補足情報を目立たせたい時に使います。
:::message と ::: で囲むことで、ボックス表示にすることができます。
入力例
:::message
「#」の後の半角スペースを忘れずに！
:::
↓（実際に適用すると…）
message の後ろに alert を付けると、警告ボックスとして表示されます。
入力例
:::message alert
もし半角スペースを入れ忘れると、見出しとして認識されません！
:::
↓（実際に適用すると…）
補足情報には message、注意点には message alert と使い分けると、読者にとってわかりやすい記事になります。
アコーディオン（トグル）
クリックすると内容が展開される折りたたみボックスです。
長い補足情報を隠しておきたい時や、ネタバレを避けたい時に便利です。
:::details と ::: で囲み、details の後ろにタイトルを記述します。
入力例
:::details クリックして展開する
ここに折りたたむ内容を書きます。
:::
↓（実際に適用すると…）
クリックして展開する
ここに折りたたむ内容を書きます。
応用編：組み合わせてみる
慣れてきたら挑戦してみましょう！
message と details は組み合わせて使うこともできます。
① details の中に コードブロックを入れる
:::details サンプルコードを見る
```txt
1. 本日は晴天なり。
```
:::
↓（実際に適用すると…）
サンプルコードを見る
1. 本日は晴天なり。
② message の中に details を入れる
::::message
:::details 補足情報を見る
2. 本日は晴天なり。
:::
::::
↓（実際に適用すると…）
③ details の中に message を入れる
::::details 注意事項を見る
:::message
3. 本日は晴天なり。
:::
::::
↓（実際に適用すると…）
注意事項を見る
::: がどれについてのものか区別できなくなってしまう場合は、外側になるものを :::: として区別できるようにします。
組み合わせ方次第で、読者にとって見やすい構成を作ることができます！
まとめ：習うより慣れろ！
今回は Markdown の本当に基礎的な部分だけを触ってみました。
最初は「記号を覚えるのが大変そう…」と思うかもしれませんが、使っているうちに、よく使う記号は自然と身についていきます。
マウスに手を伸ばす回数が減るので、「文章を書くこと」そのものに集中できるのが Markdown 最大のメリットだと感じました。
あとかっこいい。
さらに詳しく知りたい方は、Markdown の作者さんによる公式ドキュメントも参考にしてみてください。
Markdown 以外の軽量マークアップ言語について
ちなみに、Markdown 以外にも軽量マークアップ言語は存在します！
（BBCode・AsciiDoc・reStructuredText など）
最後に、冒頭の文章に Markdown を適用するとこうなります！
URL のリンク化や文字の強調など、見た目の変化に注目してみてくださいね！
Markdown とは？
ブログなどの記事を書き始める際に、必ずと言っていいほど避けては通れないMarkdown。
Daring Fireball
（Markdown の作者 John Gruber さんの公式サイト）によると
Markdown is a text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid HTML.
（訳）Markdown は、Web ライター向けのテキストから HTML への変換ツールです。Markdown を使用すると、読みやすく書きやすいプレーンテキスト形式で文章を作成し、それを構造的に有効な HTML に変換できます。
……とのことです。
文章の見た目を簡単に変更できる、HTML を使わなくてもリンクを埋め込める、など様々な便利なことができます。
ただ、何から手をつけていいかわからない……！
今回はそんな Markdown について、自学も兼ねて調べながら実践していこうと思います。
クラスメソッドオペレーションズ株式会社について
クラスメソッドグループのオペレーション企業です。
運用・保守開発・サポート・情シス・バックオフィスの専門チームが、IT・AIをフル活用した「しくみ」を通じて、お客様の業務代行から課題解決や高付加価値サービスまでを提供するエキスパート集団です。
当社は様々な職種でメンバーを募集しています。
「オペレーション・エクセレンス」と「らしく働く、らしく生きる」を共に実現するカルチャー・しくみ・働き方にご興味がある方は、クラスメソッドオペレーションズ株式会社 コーポレートサイトをぜひご覧ください。
※2026年1月 アノテーション㈱から社名変更しました。
