概要

この記事はプログラミング初学者の筆者が、一番最初にキータに投稿する際に調べたことをまとめたものです。

0 . Markdown早見表
1 . ガイドラインを確認
2 . Qiita公式のMarkdown記法　チートシート確認
3 . 見出し
4 . 補足説明
5 . コードの挿入
6 . リスト
7 . 引用
8 . 水平線
9 . リンク
10 . 折りたたみ（記事の見た目をスッキリさせて、閲覧者が必要なところのみを参照しやすくする為）
11 .　表（テーブルの自動入力）
12 . 引用、参考元サイト

0. Markdown早見表

やりたいこと	書き方
3 . 見出し	#の数が多くなるにつれて# h1,## h2,### h3...になります。（＊　#とh１の間にスペース必要）
4 . 補足説明	:::note info インフォメーション ::: 　:::note warn 警告~に注意してください。 ::: :::note alert より強い警告~しないでください。 :::
5.コードの挿入
6 . リスト	順序なしリスト :文頭に「*」「+」「-」のいずれかを入れる番号つきリスト :文頭に「数字」+「.」を入れる
7. 引用	文頭に「>」を置く
8 . 水平線	「* * 」「*******」　「- - -」「-----------」「~~~」
9 . リンク	[リンクにするタイトル名]（URL "タイトル"）
10 .折りたたみ（記事の見た目をスッキリさせて、閲覧者が必要なところのみを参照しやすくする為）
11 .　表（テーブルの自動入力）	入力補完を利用する場合　：3x2などと入力するとテーブルを自動入力できます。

1. ガイドラインを確認

いい記事を書く際に押さえていくポイントや注意（著作権など）が書いてあります。

Qiitaヘルプ:いい記事を書く為のガイドライン

2. Qiita公式のMarkdown記法　チートシート確認

ここを見れば大抵やりたいことはできます。

Qiita公式:Markdown記法チートシート

3. 見出し

注意
下記の記述で「#」と「見出し」の間に半角スペースを入れないと見出しとして認識してくれません。

書き方

# h1(#1つでh1タグになります。以下数に合わせて#を入れるとそれぞれh2、h3...となります。)
## h2
###　h3
#### h4
##### h5

結果:

h1(#1つでh1タグになります。)

h2(##2つでh2タグ)

h3(###3つでh3タグ)

h4(####4つでh4タグ)

h5(#####5つでh5タグ)

h1とh２には下線がつき、h３以降は太文字？上記↑の表示になります。

4. 補足説明

補足したい内容を強調したいとき、:::note infoと ::: で囲みます。

:::note infoと補足したい内容、:::はそれぞれ別の行に配置します。

そのほか、下記の書き方でそれぞれ補足説明を表示できます。

書き方

:::note info
インフォメーション
infoは省略可能です。
緑の背景色チェックマーク
:::

:::note warn
警告
~に注意してください。
:::

:::note alert
より強い警告
~しないでください。
:::

結果：

インフォメーション
infoは省略可能です。
緑の背景色チェックマーク

注意
~に注意してください。

より強い注意
~しないでください。

5. コードの挿入

下記のように、「Ruby」で記述したコードをファイル名「ruby.rb」として表記したい場合は　バッククォート（'）　か　チルダ（~）　を使用するとシン*タックスハイライトが適用されます。

*シンタックスハイライトとは？　
あらかじめ指定された文中の特定の記号やキーワードなどを他とは異なる色で表示すること。

書き方

~~~ruby:ruby.rb
puts 'Hello'
~~~

結果:

ruby.rb

puts 'Hello'

↓コードブロック内でコードブロックを書きたい場合は異なる記号を使うことで書けます。

6. リスト

順序なしリスト（先頭に・がつく箇条書き）

文頭に「*」「+」「-」のいずれかを入れると順序なしリストになります。
要点をまとめたり、目次作成の際に便利です。
「*」「+」「-」とリスト名の間には 半角スペース　が必要です。

番号つきリスト

文頭に「数字」+「.」を入れると番号付きリストになります。
「数字」と「.」の間には　半角スペース　が必要です。
ネスト(入れ子：あるものの中に、それと同じ形や種類の"一回り小さい"ものが入っている状態や構造のこと)する時には 段落と同じ数のスペースが必要です。

7. 引用

文頭に「>」を置くことで引用になります。
複数行を引用する場合、改行ごとに「>」を置く必要があります。
「>」と文字の間には半角スペース　を開ける必要があります。
引用の中に別のMarkdownを使用することも可能です。
ネスト（入れ子）

8. 水平線

下記の表記は水平線として表示されます。

書き方

* * *
***
*****
- - - 
----------------------------

結果（上記全てが下記のように表示されます。）

9. リンク

タイトル付きのリンク表示ができます。（タイトルは、リンク上にマウスホバーすると表示されます。）

書き方

[リンクにするタイトル名]（URL "タイトル"）

例

書き方

[Qiita](http://qiita.com "Qiitaホーム画面")

結果:

Qiita

タイトルなしリンク書き方

[Qiita](http://qiita.com)

↑この書き方をすると上記の画像のようにマウスホバーしてもリンクにタイトルは表示されません。

10. 折りたたみ

HTMLを使って折りたたみが出来ます。

HTMLタグの下には空行が必要です。

書き方

<details><summary>ここに要約として表示したい文章を書きます。</summary>

（上に空白が必要です。）

</details>

結果：

ここに要約として表示したい文章を書きます。

puts 'Hello, World'

11 .　表（テーブルの自動入力）

入力補完を利用する場合

3x2などと入力するとテーブルを自動入力できます。

xは英字のエックスなのでご注意ください。

手動入力する場合

ほとんど手動入力はないと思いますが、する場合は私は完全にコピペです。

書き方

| Left align | Right align | Center align |
|:-----------|------------:|:------------:|　←この部分の書き方によって表内の文字位置が変わります。
| How        | How         | How          |
| to         | to          | to           |
| write      | write       | write        |
| left       | right       | center       |
| a table    | a table     | a table      |

結果：

Left align	Right align	Center align
How	How	How
to	to	to
write	write	write
left	right	center
a table	a table	a table

12 . 引用、参考元サイト