一歩ずつ学ぶ

最終更新日:

markdown記法: まずはこの5つの記法でほとんどの文章は書ける

Markdown記法、便利ですよね。 わたしもよく利用しています。

本格的にMarkdown記法を覚えようと思っているかたもいると思いますが、よく使う記法は決まっています。 次の5つの記法です。

  • 見出し(hタグ)
  • 段落(pタグ)
  • リスト(ulタグ)
  • 強調(strongタグ)
  • 改行(brタグ)

この5つを知っているだけで、ほとんどの文章は書けます。 専門的な文章、例えばコンピュータ・プログラミングの解説などを書く場合を除いて、 ごく一般的な文章であればこの5つでたいていは十分です。

上記5つ以外の細かい記法については、必要な時に検索すれば間に合います。 そこで、このページでは最初に知っておくべき5つの記法について解説します。

では早速解説していきます。

見出し(hタグ)

見出しは先頭に#(シャープ)をつけます。#(シャープ)の数が見出しのレベルになります。 #(シャープ)1つで<h1>タグ。#(シャープ)2つで<h2>タグとなります。

以下でMarkdownの記述と、対応するHTMLをそれぞれ見ていきます。

Markdown

# これはh1の見出しです

## これはh2の見出しです

### これはh3の見出しです

HTML

<h1>これはh1の見出しです</h1>

<h2>これはh2の見出しです</h2>

<h3>これはh3の見出しです</h3>

段落(pタグ)

段落は空行によって囲まれた1行又は複数行であらわします。 要は「行を空ける」だけです。 具体例を見ればすぐにわかると思いますので見ていきます。

Markdown

これは1行の段落です。

これは2行にわたって書いていますが、
一つの段落です。空行があることで一つの段落となります。

これは3行にわたってかいてます。
これも
1つの段落です。

HTML

<p>これは1行の段落です。</p>

<p>これは2行にわたって書いていますが、
一つの段落です。空行があることで一つの段落となります。</p>

<p>これは3行にわたってかいてます。
これも
1つの段落です。</p>

リスト(ulタグ)

リストも文章を読みやすくするためによく使います。 リストは、*(アスタリスク)、+(プラス)、-(ハイフン)のいずれかに 半角スペースを入れます。以下では*(アスタリスク)を使って記述しています。

Markdown

* A
* B
* C

HTML

<ul>
<li>A</li>
<li>B</li>
<li>C</li>
</ul>

リスト(olタグ)

番号付きリストをつくる場合は、 数値と.(ピリオド)とスペースの後にリスト内容を記述します。 記入した数値番号ではなく、並び順に数値が振られる点に注意してください。

Markdown

1. A
2. B
3. C

HTML

<ol>
<li>A</li>
<li>B</li>
<li>C</li>
</ol>

以下のように3,2,1の順番で記述しても表示は変わりません。 HTMLでは単に<li></li>でしかないので、 あくまで並び順に番号が振られます。

3. A
2. B
1. C

強調(strongタグ)

強調は*(アスタリスク)か_(アンダースコア)で強調したい部分を囲みます。 1つならemタグ、2つならstrongタグとなります。

emタグの場合、通常はイタリック体で表示されます。 イタリック体はデフォルトの設定では文字が斜めに傾いて表示されます。 ですからフォントによっては見にくくなります。 なので強調する場合はstrongタグを使うことをおすすめします。

Markdown

テキストを*強調*します

テキストを_強調_します

テキストを**強調**します

テキストを__強調__します

HTML

<p>テキストを<em>強調</em>します</p>

<p>テキストを<em>強調</em>します</p>

<p>テキストを<strong>強調</strong>します</p>

<p>テキストを<strong>強調</strong>します</p>

改行(brタグ)

改行はテキストの末尾に半角スペースを二つ入れます。

半角スペースは見えないのでわかりにくい場合があります。 わかりやすくするための対処方法としては2つ考えられます。

  • エディタの設定で半角スペースがわかるようにする。
  • 改行タグを自分で入力する。

私は2番目の方法をとっています。 <br>と入力するだけですから、全然手間ではありません。 お好きな方法で行ってください。

Markdown

テキスト (半角スペース2つ)
テキスト

HTML

<p>テキスト<br>
テキスト</p>

細かく言うと、通常HTMLの改行は<br>、XHTMLの改行は<br />です。 ツールによって<br>に変換するか、<br />に変換するかが違います。 気になる方は注意してください。 ただしどちらでもブラウザは解釈してくれますので あまり気にする必要はありません。

まとめ

以上、見出し・段落・リスト・強調・改行の5つについて見てきました。 実際にMarkdown記法で文章を書いてみると、この5つだけでほとんどの文章が書けることがわかると思います。 その他の記法は必要な時に調べれば十分対応できます。

↑ PAGE TOP