ITキャリアの悩みを無料相談で解決! カウンセラーにITキャリア相談

今日から始めるマークダウン!基本的な書き方を解説

作成: 2020.04.21 更新: 2020.04.17

>>10年後も職を失わない「求められる人材」になる

読むだけでIT転職が有利になる限定資料はこちら

HTMLよりも手軽に扱え作業の効率化が期待できるマークダウンは、ドキュメント作成時に重宝するツールです。

「ぜひ使ってみたい」という人も多いのではないでしょうか。

そこで今回は、すぐに使えるマークダウンの基本的な書き方について、導入方法や注意点も含めながら紹介します。

しっかり読んで、早速今日から導入してみましょう!

マークダウンを使ってみよう

マークダウンには「エディタを選ばなくてよい」「HTMLタグよりも入力が簡素である」といったメリットがあります。
ここではまず、マークダウンを活用する際のポイントを紹介しますので、チェックしておきましょう。

マークダウンの導入方法

まずは、マークダウンの導入方法です。
マークダウンは、導入するだけであれば特殊なエディタは必要ありません。例えば、デフォルトでインストールされているメモ帳などのツールでも容易に始められます。

マークダウンを意識して作られた便利なエディタを使うことで、ドキュメントを作成しながらリアルタイムで反映された画面を確認できるなど、さらに便利になります。

エディタにはいくつか種類がありますが、どのエディタも特別な環境構築をする必要はなく、PCにインストールすればすぐに使えます。

ですので「マークダウンを使いたい!」と思ったら、すぐに実践可能です。

マークダウンで使えるエディタについては、以下の記事で詳しく紹介していますので、ぜひ参考にしてください。

マークダウンとは?ITエンジニアにおすすめのドキュメント制作ツールを紹介

書き方の方言に注意

マークダウンを利用する際には、1つ注意点があります。
それは、記述が簡単なマークダウンにも「方言」があるということです。

この方言とは、例えばGitHubなどにあるのですが、一般的なマークダウンに足りない記述を補正してくれるものです。一般的なマークダウンだけを利用する場合にはほとんど気にする必要はありません。

しかし、以下のようなツールを使う場合には方言を意識しましょう。

  • CommonMard
  • Markdown Extra
  • GitHub Flavored Markdown
  • Maruku

より多くの装飾を使いこなしたり、書きやすさを追求したりするために方言は利用されています。マークダウンの基本的な使い方に慣れてきたら意識してみましょう。

マークダウンの書き方を紹介

それでは早速、マークダウンの書き方を見ていきましょう。
一度覚えてしまえば、無意識にでもタイピングできるようになりますし、いくつかの法則を覚えるだけで様々なメリットがあります。

まずは、基本的な部分からはじめてみましょう。

強調

強調したい文字をアスタリスク2個「**」で囲みます。

例えば「あいうえお」の中で「うえ」だけを強調したい場合は以下のように記述しましょう。

あい**うえ**お

これにより「うえ」だけが強調した装飾で表示されます。

斜体

斜体にしたい文字は、アスタリスク1つ「*」で囲みます。

例えば「あいうえお」の中で「うえ」だけを斜体にしたい場合は、以下のような表記です。

あい*うえ*お

これで「うえ」が斜体で表示されます。

改行

改行もマークダウンで記述できます。

改行を入れる場合は、改行を入れたい部分に2つの「半角スペース」を入力するだけです。

例えば「あいうえおかきくけこ」を2行で表示した場合には、「お」と「か」の間に半角スペースを2つ入れましょう。

あいうえお(半角スペース)(半角スペース)かきくけこ

これにより「お」の後で改行され、2行で表示されます。

水平線

文章を区切るための水平線は、次のいずれかを3つ連続で入力します。

・アスタリスク「***」
・ハイフン「—」
・アンダースコア「—」

例えば「あいうえお」「かきくけこ」の間に水平線を入れたい場合は、以下のような表記になります。

あいうえお

かきくけこ

取り消し線

文章に取り消し線を表記するには2個のチルダ「~~」で文を挟みます。

例えば「あいうえお」に取り消し線を付ける場合には、以下のように入力しましょう。

~~あいうえお~~

チェックボックス

チェックボックスは、ハイフン「-」とカッコ「[ ]」で作成できます。

また、チェック済みを表現するときは、アルファベットの「x」をカッコ内に入力してください。

例えば、ToDoリストであれば以下のように表現できます。

未完了:- [ ] 項目1
完了 :- [ x ] 項目2

段落

文章に段落を入れるには、文末に半角スペースを入れます。

例えば「あいうえおかきくけこ」という一文の「お」の次に段落を入れる時は、以下のように記入しましょう。

・あいうえお かきくけこ

これで、段落が挿入されます。

箇条書き

箇条書きをするには、文字の先頭にアスタリスク「*」を入力します。

例えば、以下のような表記です。

*項目1
*項目2
*項目3
*項目4
*項目5

ここで入力するアスタリスクは1つですので、間違えないようにしましょう。

ナンバリング

ナンバリングを行うには、文字の先頭に数字とピリオド「.」を入力します。

例えば、以下のような表記です。

1. 項目A
2. 項目B
3. 項目C
4. 項目D
5. 項目E

画像

画像ファイルを挿入するには、先頭にエクスクラメーションマーク「!」、続けて[代替テキスト]、最後に(URL)を入力します。

これらを続けて入力すると以下のようなイメージです。

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

URL画像が保存されているURLを入力してください。

リンク

リンクを挿入する場合は、[リンクテキスト](URL)で表記します。

例えば当サイトをリンクする場合には、次のような記述です。

[テックキャンプ ブログ](https://tech-camp.in/note/)

引用

引用では、引用する文章の前に大なり「>」で表記します。

例えば「あいうえお」を引用するときは次のように入力しましょう。

> あいうえお

テーブル

テーブルはパイプライン「|」とハイフン「-」を組み合わせることで利用できます。

例えば、3列3行のテーブルは以下のように作成しましょう。

| あ || い || う |
| え || お || か |
| き || く || け |

自宅で学べて安心!オンラインでエンジニア転職を実現

テックキャンプ エンジニア転職は、受講生の3人に1人がオンライン受講
◎オンライン受講の満足度は4.4/5点の高評価
まずは、ITキャリアの悩みを無料カウンセリングで相談!

マークダウンには様々なメリットが。基本から始めてみよう

マークダウンを使えば、いくつかの記号だけでドキュメントに効率的に装飾を行うことができます。
利用するサービスによっては、補足的なフォーマットを追加した方言を覚える必要もありますが、基本的な記号を抑えておくだけで、比較的簡単に利用できるでしょう。

マークダウンは作業効率化のためにも覚えておいて損のないものです。ぜひ活用してみてください。

受講料最大50,000円OFF!先の見えない時代でも求められる人材「ITエンジニア」を目指すチャンス

「今の仕事は、10年後も必要とされているだろうか……」と、将来の働き方に不安を抱えていませんか?
不安定で先の見えない時代でも求められる人材になりたいなら、ITエンジニアがおすすめです。
テックキャンプなら、IT業界未経験・知識0の人でもエンジニア転職を実現できます。
今なら、9/30までの期間限定で受講料が最大50,000円OFF!
無料オンラインカウンセリングで、今すぐIT転職への不安を解消しましょう!

無料カウンセリングの予約はこちら

この記事を書いた人

佐久森
テックライター 佐久森 福岡県出身の東京都在住。ITインフラエンジニア10年以上の経験から、IT技術全般を初心者向けに分かりやすく解説。また、ITエンジニアの働き方に関する情報などを執筆中。