QiitaのMarkdoun記法 書き方(基礎)


#はじめに
Qiitaで記事を書く時のMarkdownについて調べてみたので、基礎だけでもまとめてみました。
初めての方でもわかりやすく書いたつもりなのでよかったら参考にしてみて下さい。

#1.見出し
文頭に**「#」**をつけると「見出し」にすることができます。
見出しはh1〜h6まで有り、「#」の**個数**で表すことができます。

###○記述例

```
#見出し
##見出し
###見出し
####見出し
#####見出し
######見出し
```

###○表示例

#見出し
##見出し
###見出し
####見出し
#####見出し
######見出し

#2.コード挿入

記事内にコードを挿入したいときは__バッククォート「 ` 」__を使います。
表示したいコードの**始めと終わりに**バッククォート__3つ__ずつで囲みましょう。
ちなみにバッククォート**「 ` 」**の出し方は**「 Shift + @ 」**です。

###○記述例
__```__
＜form class= “contact-form”>
　＜input type= “text” placeholder= “NAME”>
　＜textarea name=“message” placeholder=“MESSAGE”>
　＜input  type=“submit” value=“SEND”>
＜/form>
__```__

###○表示例

```
<form class= “contact-form”>
　<input type= “text” placeholder= “NAME”>
　<textarea name=“message” placeholder=“MESSAGE”>
　<input  type=“submit” value=“SEND”>
</form>
```

#3.コードにシンタックスハイライト、ファイル名をつける
挿入したコードにはシンタックスハイライトを入れたり、ファイル名をつけることができます。

記入方法は__「 ```言語名:ファイル名 」__です。

例えばHTMLだと下記のようになります。

###○記述例
__```__html:index.html
＜form class= “contact-form”>
　＜input type= “text” placeholder= “NAME”>
　＜textarea name=“message” placeholder=“MESSAGE”>
　＜input  type=“submit” value=“SEND”>
＜/form>
__```__

###○表示例

```html:index.html
<form class= “contact-form”>
　<input type= “text” placeholder= “NAME”>
　<textarea name=“message” placeholder=“MESSAGE”>
　<input  type=“submit” value=“SEND”>
</form>
```
シンタックスハイライトを使えるのは以下の言語です。
主要な言語はだいたい使えます。
>Bash, C#(cs), C++(cpp), CSS, Diff, HTML, XML, Ini, Java, Javascript, PHP, Perl, Python, Ruby, SQL, 1C, AVR Assembler(avrasm), Apache, Axapta, CMake, DOS .bat(dos), Delphi, Django, Erlang, Erlang, REPL, Go, Haskell, Lisp, Lua, MEL, Nginx, Objective C(objectivec), Parser3, Python, profile, Scala, Smalltalk, TeX, VBScript, VHDL, Vala

#4.コードの一部を表示する
ハイライト付きでコードを表示する方法は表示したいコードを__バッククォート__で囲みます。

###○記述例
```
`rails db:migrate`
```

###○表示例
`rails db:migrate`

#5.文字を太字(強調)にする
文字を__太字__にするには太字にしたい箇所の始めと終わりを**2個ずつ**の**アスタリスク「 * 」**もしくは__2個ずつ__の**アンダースコア「 _ 」**で囲みます。

###○記述例
```
**アスタリスクで囲む**

__アンダースコアで囲む__
```

###○表示例

**アスタリスクで囲む**

__アンダースコアで囲む__

#6.リンクを挿入する
リンクを挿入したいときは **[リンクしたいテキスト]**__(URL)__ と記入します。

###○記述例
```
[Googleに移動します](https://www.google.com/?hl=ja)
```
###○表示例
[Googleに移動します](https://www.google.com/?hl=ja)

#7.箇条書きリスト
箇条書きのリストは、文頭に__「*」「+」「-」__のいずれかの__記号__を入れると表示できます。
その際記号と文の間に**半角スペース**を**一つ**空けましょう。
また、リストの__上下に間隔__を空けないと__正しく表示されない__場合もあるので注意。


###○記入例①
```
* HTMLの基本

+ CSSの基本

- rubyの基本
```

###○表示例①

* HTMLの基本
 
+ CSSの基本
 
- rubyの基本

###記述例②
```
* HTML
    + HTML_1
       - HTML_1_1
       - HTML_1_2
    - HTML_2
- CSS
- ruby
```

###表示例②
* HTML
    + HTML_1
       - HTML_1_1
       - HTML_1_2
    - HTML_2
- CSS
- ruby

例②ようにリストを**ネスト(入れ子構造)**させることもできます。

#8.番号付きのリスト
番号付きのリストは、文頭に__「数字 . 」__をを入れると表示できます。
その際__「数字 . 」__と文の間に**半角スペース**を**一つ**空けましょう。
また、リストの__上下に間隔__を空けないと__正しく表示されない__場合もあるので注意。



###○記述例
```
1. html

2. css

3. ruby
```

###○表示例
1. html

2. css

3. ruby

#9.テーブル(表)
テーブルは**「 | 」 「 - 」 「 : 」**を使って作成します。
ヘッダー下の**2行目**の**コロン「 : 」**でテーブル内の**文字の配置**を決定します。

**|:---| → 左揃え**
**|:---:| → 中央揃え**
**|--:| → 右揃え**

###○記述例
```
|左揃え|中央揃え|右揃え|
|:---|:---:|--:|
|align-left|align-center|align-right|
|セルの左揃えです|セルの中央揃えです|セルの右揃えです|

または

|左揃え        |中央揃え        |右揃え        |
|:------------|:------------:|------------:|
|align-left   |align-center  |  align-right|
|セルの左揃えです|セルの中央揃えです|セルの右揃えです|
```

###○表示例
|左揃え|中央揃え|右揃え|
|:---|:---:|--:|
|align-left|align-center|align-right|
|セルの左揃えです|セルの中央揃えです|セルの右揃えです|

#10.引用
引用を使う場合は__「 > 」__を記述します。
引用をネストする場合は__「 > 」__を**複数回**使えば可能です。
また、二重引用(ネスト)から引用に戻すためには、一回改行する必要があるみたいです。

###○記述例
```
>引用文です。
>>ネスト１です。
>まだ引用です。

>引用文に戻りました
>>>ネスト２です
```

###○表示例
>引用文です。
>>ネスト１です。
>まだ引用です。

>引用文に戻りました
>>>ネスト２です


#11.マークダウンの無効化
**バックスラッシュ「 \ 」**をMarkdownの前につけることでMarkdownを__無効化__出来ます。
**「 \ 」**は__「option + ¥」__で記述することができます。

###記述例
```
\#見出し
```

###○表示例
\#見出し

↑
文頭に「 \ 」をつけると、このように「 # 」が適用されなくなります。

#参考

[Markdown記法 チートシート](https://qiita.com/Qiita/items/c686397e4a0f4f11683d)

[Qiita Markdown 書き方 まとめ](https://qiita.com/shizuma/items/8616bbe3ebe8ab0b6ca1)

[Markdown記法 サンプル集](https://qiita.com/tbpgr/items/989c6badefff69377da7)