title: Qiita Markdown 書き方 まとめ tags: Qiita Markdown author: shizuma
Markdownの書き方をまとめました。 はじめての方でもQiitaをすぐに使えるように出来るだけわかりやすく書いたつもりです。
はじめての方は、下記目次の1~3くらいを覚えて使ってみて、徐々に4以降も使うようにしていけば良いと思います。 (完全な独断でよく使うだろうというものから順番にしています。)
文頭に#をつけることで見出しにすることが出来ます。 また、#の数で見出しに重みを下げることが出来ます。 htmlでいうところのh◯の◯が#の数ということです。 以下のように使います。 >
#見出しh1
##見出しh2
###見出しh3
コードの挿入の基本は```(バッククオート3つ)でコードをくくることです。 ` はバッククオートです。クォーテーション ' ではありません。ご注意を。 > ``` function hello(){ return "hello world!"; } ``` のように書くと >
function hello(){
return "hello world!";
}
のように記載出来ます。
また、コードにシンタックスハイライトをつけることが出来ます。 各言語にシンタックスハイライトが付けられます。 例えば、phpを例にとると > ```php function hello(){ return "hello world!"; } ``` のように書くと >
function hello(){
return "hello world!";
}
シンタックスハイライトを使えるのは以下の言語です。(Markdown記法チートシートより引用) html、css、php、ruby、python… 何でも使えるという認識でとりあえず大丈夫です。 > 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
さらに、コードにファイル名を入れることも出来ます。```php:(ファイル名)とするだけです。
>
```php:hello.php
function hello(){
return "hello world!";
}
```
のように書くと
>
php:hello.php
function hello(){
return "hello world!";
}
コードブロックの左上にファイル名がついたことがわかります。
リンクの挿入は、[リンクテキスト](URL)と書きます。 > [Qiita](http://qiita.com/) のように書くと Qiita
タイトル付きリンク（タグにtitleがつきます）は[リンクテキスト](URL "タイトル")と書きます。 > [Qiita](http://qiita.com/ "キータ") のように書くと Qiita
画像の挿入は、と書きます。
>
のように書くと
>
タイトル付きにするにはリンクと同様にと書きます。
>
のように書くと
>
ただし、Qiitaでの編集の場合はドラック&ドロップで画像が挿入されるので、画像の挿入を手動で入力する必要はありません。
>を書くだけです。 ただし、改行するときはその度に>を書く必要があるので注意です。 > >ここに引用文を書きます。
ここに引用文を書きます。
引用の中で別のMarkdown記法を使うことが出来ます。
ちなみに、引用をネストするときは>を複数書くとネストされます。 > >引用文です >>ネストです
引用文です
ネストです
> _イタリック_ イタリック > *イタリック* イタリック
> __太字__ 太字 > **太字** 太字
リストの上下に空白を入れないと正しく表示されないので注意。 また、記号と文の間に半角スペースを入れること。
文頭に「*」「+」「-」のいずれかを入れる。 > * 順序なしリスト > * 順序なしリスト
文頭に「数字.」を入れる。 見た目はほぼ変わりません。
> 1. リスト1 2. リスト2
「*」か「-」を3つ以上一行に書く。 以下は全て水平線となる。 > *** * * * --- - - - > 全部以下の水平線
以下のようにテーブルを組みます。 基本は「|」でくくっていくことです。 2行目がポイントで、2行目のコロンの位置によってセル内の文字の配置が変わります。
> |左揃え|中央揃え|右揃え| |:---|:---:|--:| |align-left|align-center|align-right| |セルの左揃えです|セルの中央揃えです|セルの右揃えです| > >
| 左揃え | 中央揃え | 右揃え |
|---|---|---|
| align-left | align-center | align-right |
| セルの左揃えです | セルの中央揃えです | セルの右揃えです |
「\」をMarkdownの前につけることでMarkdownを無効化出来ます。 この記事ではこれを多用しました。 > \#見出しh1 とすると #見出しh1 となります。
Qiitaを見ていると「これはどんな記法で書いてあるんだろう」ときになることがあるかもしれません。 そんな時はMarkdown記法で見たいURLの最後に.mdをつければ見ることが出来ます。