技術・スキル

マークダウン記法、実は○○を知るだけで十分

マークダウンは見出し・箇条書き・太字の3つだけ覚えれば、実務の80%がカバーできます。

必要な道具

テキストエディタ(メモ帳・VSCode・Notion) / マークダウン対応アプリ

最重要3つの記法

1. 見出し(#)

# 大見出し

## 中見出し

### 小見出し

*2. 箇条書き(- または )

– 項目1

– 項目2

– 項目3

3. 太字()**

**太字にしたい文字**

この3つで実務の80%がカバーできます。

よく使う記法(残り20%)

リンク – [表示テキスト](URL)

画像 – ![代替テキスト](画像URL)

コード – `コード` でインライン、“`で複数行

引用 – > 引用文

水平線 – —

– | 列1 | 列2 | で表を作成

実務での使い方

議事録 – 見出しで項目分け、箇条書きで内容を整理

ブログ – 見出しで構成、太字で重要ポイントを強調

README – プロジェクトの説明を見出しと箇条書きで整理

メモ – Notionやメモアプリでサッと整理された文書を作成

Tips

  • 見出しは改行必須 – #の後に必ず半角スペース。# 見出し(○)、#見出し(×)
  • 箇条書きも半角スペース – -の後に半角スペース。- 項目(○)、-項目(×)
  • プレビューで確認 – VSCodeやNotionのプレビュー機能で見た目を確認しながら書きます。
  • HTML混在OK – マークダウンの中にHTMLタグも書けます。複雑なレイアウトはHTMLで。

まとめ

マークダウンは見出し(#)・箇条書き(-)・太字(**)の3つで実務の80%カバー。ポイントは「この3つを完璧に」「半角スペース必須」「プレビューで確認」「シンプルが最強」。複雑な記法は不要です。

注意事項

記号の後に半角スペース必須 / プレビューで確認 / 複雑な記法は不要 / シンプルに書く