Markdown 書き方の基本をまとめてみた

　　
#Markdownとは?メリットは？

Markdownとは簡単に言うと、デジタル文章の書き方の１つです。メリットとしては、

• 簡単かつ覚えやすい
• 簡単にHTMLに変換が可能
• 対応するツールが多い

などが挙げられます。

#Markdownっていつ使えるの？

Markdownは、ブログや文書を書く際に、非常に簡単に書くことができます。
有名どころでは、

• はてなブログ
  • はてなブログで記事を書くときは
    • 見たままモード
    • はてな記法モード
    • Markdownモード
      と３つの書き方を選ぶことができ、Markdownはその１つである。
      　　
      　　
• Qiita
  • 私が書いたこのQiitaの記事も、もちろんMarkdownで書かれています
    　　
    　　
• GitHub
  • GitHub内で、各説明がまとめられているREADME.mdはMarkdownを採用

このように、Markdownは多くの環境で使われています。簡単で見た目も綺麗なため、非常に使い勝手の良いマークアップ言語と言えます。

#おすすめのMarkdownエディタ

• Atom

  • AtomはGitHubが開発したエディタです。Mac、Windowsなど多くの環境で使用することができるエディタの一つである。様々なプログラム言語に対応しているため、おすすめである。

• Visual Studio Code

  • Visual Studio CodeはWindowsで有名なMicrosoft製のエディタであり、「Open Preview」を選択することで、プレビューを確認することができます。

• MacDown

  • MacDownはOS X用のMarkdownエディタです。自動補完機能やプレビュー表示などが特徴です。

私が使用しているエディタは、３番目に紹介したMacDownです。
理由としては、私自身がMacユーザであるということ。また、多くの機能はいらず、エディタの見た目が変更できるツールであるという点にマッチしたからである。　　

MacDownでは、エディタの見た目はもちろん、文字数の表示、HTMLへの書き出しも行えるため、非常に愛用している。

あなたのPC環境や欲しいエディタ機能に、マッチしたツールを選択することが一番!!

#Markdown の書き方 - 基本編 -

##・見出し
見出しの先頭部分に#をつけます。
#が増えることに小さな見出しになります。

入力

#大きい見出し
##中くらい見出し
###小さい見出し
####さらに小さい見出し

結果　

---

#大きい見出し
##中くらいの見出し
###小さい見出し
####さらに小さい見出し

---

　　

##・リスト
リストには通常のリストと数字付きリストの２種類があります。

まず、数字付きリストは、先頭部分に 1.とつけると表示できます。
(数字部分は他の数字でも良いです)

入力

1. 数字付きリスト1
1. 数字付きリスト2
1. 数字付きリスト3 

結果

---

1. 数字付きリスト1
2. 数字付きリスト2
3. 数字付きリスト3

---

次に、通常のリストは、先頭部分に-,+または*のどれかをつけると表示できます。
また、リストではtabキーを使うことにより階層化を行うことができます。

入力

- 通常リスト
* 通常リスト
+ 通常リスト

- 階層化１
	- 階層化2-1
	- 階層化2-2 

結果

---

• 通常リスト

• 通常リスト

• 通常リスト

• 階層化１
  • 階層化2-1
  • 階層化2-2

---

##・区切り線
区切り線を表示するには、*か-か_のどれかを３つ並べて入力します。

入力

***
---
___

結果

---

↑のように表示されます。　　

##・強調
文章の一部など、強調したい部分を**で囲うと強調された文字になります。

入力

**この場所**を強調します。

結果　　

---

この場所を強調します。

---

##・コードの表示
コードの表示では、バッククォートを使用して表示を行います。
様々な言語での記述も可能ですが、今回は最もシンプルな部分だけ紹介します。

入力

    ```
    ここにコードを記入する
    ```

結果

---

ここにコードを記入する

---

コードをインライン表示したい場合は、

入力

`バッククォート１つで囲む`

結果

---

バッククォート１つで囲む

---

##・リンク
外部サイトのリンクを表示したい場合は、

入力　　

[リンク名](URL)
例: [マイページ](https://qiita.com/Hase-pro)

と書きます。

結果

---

マイページ

---

##・画像の表示
画像の表示は、

• ![代替テキスト](画像のURL)
• ![代替テキスト](画像のURL "タイトル名")

によって行えます。
(Qiitaでの画像表示では、エディタに載せたい画像をドラッグ&ドロップ、または画像挿入ボタンを使うのが容易だと思います。)

#おわりに

今回は私自身もMarkdown記法の練習を兼ねて、Markdownの基礎をまとめてみました。
書いていても思いましたが、Markdownは書きやすくて、とても可読性が高いですね！
これからもMarkdown愛用していきたいと思っています！！

##参考にさせていただいたサイト
Markdown記法 チートシート
省エネHTML入力！基本Markdown記法のチートシート
Markdown書き方メモ
Markdown記法一覧
Markdown の書き方 - 基本構文