【Qiita/初心者】マークダウン記法まとめ
概要
Qiitaで記事を投稿したい。
そんな方に知ってほしい「マークダウン記法」をまとめました。
(一部マークダウンじゃないのもあります)
試しに使ってみてください。
基本
見出し
#(半角スペース)文字
マークダウン | HTML |
---|---|
# h1見出し | <h1>h1見出し</h1> |
## h2見出し | <h2>h2見出し</h2> |
### h3見出し | <h3>h3見出し</h3> |
#
の後ろの半角スペースはなくても見出しは表示されます。
ただ、ブログ等で用いられるWordPressでは、半角スペースがないと見出しとして認識されませんでした(たしか)
よって他の媒体でも汎用的に使えるように、半角スペースを入れることをおすすめします。
(ちなみに半角スペースをいくら入れても文字の位置は動きません)
改行
文字を書いて、
一回だけ改行すると、
このようにすぐ下に文字が表示されます。
文字を書いて、
二回改行すると
このように間が空きます。
これは何回改行しても同じ幅です。
行間をもっと広げたい : <br>
タグ
<br>
タグを使うと、
使った数だけたくさん行間を広げられます。
ちなみにこの記事は、<h1>見出し
の前に<br>
を入れています。
リンク
<a href="リンク先URL">表示したいリンク名</a>
Gyazo, Gyazo GIFのリンク先プレビュー
![demo](画像やGIFのURL/raw)
文字の装飾
太字
**太字にしたい文字**
太字になります
斜体
_斜体にしたい文字_
*もしくはこの書き方*
どちらでも斜体になります
引用
>(半角スペース)引用したい文字
これで引用できるようになります
僕はよくエラー文と、その日本語訳などに使ったりしますね。
マーカー(エスケープ)
バッククオート2つ `` で文字を囲むと。
このように表示されます
ちなみにこの場合、
<h1>HTMLタグなどもエスケープされて表示されます</h1>
コードの挿入
上下にバッククオート3つ ``` を書いて、その間に記載します。
このように黒い背景になります
このコードブロックを使うときは、前後に改行を入れてください。
そうしないと表示されません。
ファイル名の挿入
もし、ファイル名を挿入したい場合は、上側の```に続いてファイル名を入力。
<h1>このようにファイル名が上に表示されます</h1>
<h2>拡張子に合ったシンタックスハイライトが表示されます</h2>
def string
puts "rubyならこんな感じです"
end
string
# コメントアウトもしっかり表示されます。
<!-- HTML用のコメントアウトはRubyファイルでは認識されません -->
ファイル名の挿入(どんなファイル名もOK)
先頭にコロン ":" を入れるとファイル名を表示できます。
```:terminal
みたいな感じです
こんな感じです。
下の例では":"をつけずに書いてみます。
やはりterminalの文字は表示されませんね。
Railsを使う方へ(ERBファイルのハイライト)
Railsで用いるERBファイルについて。
index.html.erb
のように書いてみましょう。
<h1>ファイル名は表示されますが</h1>
<h2>ハイライトはされません</h2>
ERBはハイライトがサポートされているのに、ファイル名をそのまま書いても適用されません。
この場合はerb:index.html.erb
のように書きましょう。
<h1>これでハイライトされるようになりました</h1>
もしシンタックスハイライトがサポートされているのに認識されないときは、この記法を使ってみましょう。
リスト
箇条書き
*(半角スペース)リストの文字
- これでリストを書けます
- ちなみに改行直後にTABキーを押すと
- このように入れ子を使えます
- 3段目以降は
- 同じマークになるようですね
- さらに
- 3段目以降は
- 改行した後に Shift+TAB で
- このように入れ子を使えます
- このようにインデントを上げることができます
もし、間を空けたい時は。
リストを書いてから
2回改行して
さらにリストを記載します
順序あり
1.(半角スペース)リストの文字
- このように
- 改行すると、
- 数字が自動で挿入されます
- ちなみにTABを押すと
- 入れ子構造を作れます
- そしてShift+TABで
- 入れ子を戻せます
表(テーブル)
中央揃え
| 1 | 2 |
|:-:|:-:|
| 値1 | 値2 |
| longlong | longlong |
1 | 2 |
---|---|
値1 | 値2 |
longlong | longlong |
左揃え(デフォルト)
| 1 | 2 |
|---|---|
| 値1 | 値2 |
| longlong | longlong |
1 | 2 |
---|---|
値1 | 値2 |
longlong | longlong |
右揃え
| 1 | 2 |
|--:|--:|
| 値1 | 値2 |
| longlong | longlong |
1 | 2 |
---|---|
値1 | 値2 |
longlong | longlong |
テーブルをぱぱっと出す(列x行)
列x行 (x:"エックス")
と入力してエンターを押すと、
1 | 2 | 3 | 4 |
---|---|---|---|
簡単にテーブルを作れます。
水平線
---
***
これで区切り線が表示されます。
どちらの方法でもできますね。
さいごに
技術のアウトプットをすると、「人に見られる」という責任感からか、インプットの質も必然的に上がります。
もしアウトプットを始めたい方は、ぜひこのページを見ながら試してみてください!
Author And Source
この問題について(【Qiita/初心者】マークダウン記法まとめ), 我々は、より多くの情報をここで見つけました https://qiita.com/saika_0/items/ce0e448fcdf1e47a477a著者帰属:元の著者の情報は、元のURLに含まれています。著作権は原作者に属する。
Content is automatically searched and collected through network algorithms . If there is a violation . Please contact us . We will adjust (correct author information ,or delete content ) as soon as possible .