マークダウン記法とは?知っておくと便利な理由

マークダウンとは何か

マークダウン(Markdown)とは、簡単な記号を使うだけで、見出しや箇条書き、強調などの装飾を加えられる、文章の書き方のルール(記法)のことです。ワープロソフトのように、ボタンをクリックして装飾するのではなく、決められた記号を文章中に直接書き込むことで、装飾を指定します。

基本的な書き方の例

マークダウンにはいくつかの基本的なルールがあります。

• 見出し:文頭に「#」の数を変えて書くことで、見出しの大きさを指定できます(「# 大見出し」「## 中見出し」など)
• 箇条書き:文頭に「-」や「*」をつけると、箇条書きのリストになります
• 強調(太字):文字を「**」で挟むと、太字で強調されます
• リンク:「表示する文字」という形式で、文章中にリンクを埋め込めます

これらの記号を覚えるだけで、見た目の整った文章を、キーボードだけで素早く作成できるようになります。

もう少し覚えると便利な記法

基本の4つに慣れてきたら、次のような記法もあわせて覚えておくと、表現の幅が広がります。

• コードブロック:文章中にプログラムのコードをそのまま貼り付けたい時、「```」で前後を囲むと、コードだけを区別して表示できます(この記事内の他の記事でも、SQLの例文などで使われています)
• 表(テーブル):「|」の記号を使って、行と列を持つ表を作成できます
• 引用:文頭に「>」をつけると、引用文であることを示す表示になります

なぜエンジニアの間で広く使われているのか

マークダウンで書かれたファイルは、装飾のための特別なソフトがなくても、単純なテキストファイルとして誰でも開いて読むことができます。この「特別なソフトに依存しない、シンプルなテキストである」という特徴が、プログラムのコードと同じように管理・共有しやすいため、GitHubなどの開発現場で広く採用されています。

ワープロソフトとの違い

どんな場面で使われているか

• GitHubやGitLabにおける、プロジェクトの説明文書(README)
• SlackやNotionなど、多くのビジネスツールでのメモ・メッセージ入力
• 個人のブログ記事の執筆(この記事自体も、マークダウンで書かれています)

一度覚えてしまえば、複数のツールで共通して使える汎用的なスキルになります。

覚え方のコツ

いきなり全ての記法を覚えようとせず、まずは「見出し(#)」「箇条書き(-)」「太字(**)」という、最も使用頻度の高い3つから使い始めてみるのがおすすめです。慣れてくるにつれて、自然と他の記法も身についていきます。

運営者自身も学習中に同じ疑問を持ったことがあり、その経験も踏まえてまとめています。

まとめると

マークダウンは、シンプルな記号だけで文章を装飾できる、汎用性の高い記法です。プログラミングに直接関わらない人でも、覚えておいて損はないスキルです。基本の3つに慣れたら、コードブロックや表にも挑戦してみてください。