derric.org

Markdownの書き方

| トラックバック(6)

Markdownは、読み書きしやすい(HTMLの)原文を書くための記述法です。
ライブラリ化されており、いろんな場所で使われています。
MovableTypeでも使えるので、書き方を学んでみました。

原文:Daring Fireball: Markdown Syntax Documentation
和訳:Markdown文法の全訳
わかりやすい説明:Markdownの記法

実際に使ってみるとすごい楽。
昔自分でルールを作ってPHPで解釈させていたことがありましたが、
これはその完成形ですね。よくできています。

基本的には、英語圏のメール文法を参考にしている模様。
直感的で良いと思います。

Markdown覚書

  • 段落 <p>~</p>:空行をはさむと段落が切り替わる
  • 見出し <h#>~<h#>:行頭の"#"の数で決める(#=h1, ##=h2,,,######=h6)
  • 引用 <blockquote>~</blockquote>:行頭に"> "を置く
    ※段落の先頭に"> "を置くと、その段落全体が引用になる
    ※"> "を重ねると、引用をネストできる
    ※引用の中でMarkdown記法が使える
  • リスト 数字なし:<ul><li>~</li></ul>:行頭に"* "、"+ "、"- "のどれかを使う
    数字あり:<ol><li>~</li></ol>:行頭に数字とピリオドを入れる(使用する数字は何でもよい)
    ※liの中で改行しても、左のマージンを空けるためにインデントする必要はない
    ※liとliの間に改行を入れると、liの中身がpで囲まれる
    ※liの中身を複数の段落にするときは、段落の頭に空白4つまたはtabを入れる
    ※liの中に引用を入れるときは行頭の"> "をインデントする
    ※liの中にcodeを入れるときは行頭に空白8つ入れる
    ※文頭に数字+ピリオドがきちゃうけどolにしたくないときはピリオドの前にバックスラッシュ(2010\.)
  • コード <code>~</code>:行頭に空白4つまたはtabを入れる
    ※インデントが続く限りコードブロックのまま
    ※コードの中の<>や&はHTML entityに変換される
    ※コードの中ではMarkdown記法は無効
  • 水平線 <hr />:"*"、"-"、"_"のどれかを3つ以上書くと水平線になる。間に空白が入っても可
    ※"-"は<h2>と間違われることがあるので注意
  • リンク <a>~</a>
    インライン:[リンクテキスト](http://exmaple.com/ "タイトル")
    リファレンス:
    a) インラインで [リンクテキスト][id] と書き、別の行で [id]: http://example.com/ "タイトル" と書く
    b) インラインで [リンクテキスト][] と書き、別の行で [リンクテキスト]: http://example.com/ "タイトル" と書く
    ※URLが長い時は、タイトルを次の行に書ける。その場合、行頭に空白またはtabを入れる
  • 強調 <em>~</em><strong>~</dtrong>:"*"または"_"ではさむ。1個でem、2個でstrong。
    ※うまく反映されないときはバックスラッシュを使う
  • コード(部分) <code>~</code>:"`"(バッククオート)ではさむ
    ※<>や&はHTML entityに変換される
  • 画像 <img />:リンクの記法の頭に"!"をつける。![altテキスト](http://example.com "タイトル")。リファレンスも可。
  • 自動リンク <a>~</a>:"< >"で囲むと自動リンクになる
    例 リンク) <http://example.com/>=[http://example.com/](http://example.com/)
    例 メアド) <address@example.com>=[address@example.com](mailto:address@example.com)
  • バックスラッシュでエスケープできる文字は以下の通り
    \ ` * _ {} () [] # + - . !
    ※<>はエスケープできない。ていうか、そのまま書けばHTML entityになるので。

トラックバック(6)

トラックバックURL: http://tech.derric.org/mt/mt/mt-tb.cgi/15

Markdownの書き方 - tech@derric 続きを読む

ティンバーランド 靴 - ティンバーランド 靴 (2014年2月26日 06:40)

Markdownの書き方 - tech@derric 続きを読む

Markdownの書き方 - tech@derric 続きを読む

Markdownの書き方 - tech@derric 続きを読む

クロエ トートバッグ - クロエ トートバッグ (2014年3月 4日 01:36)

Markdownの書き方 - tech@derric 続きを読む

Markdownの書き方 - tech@derric 続きを読む

ページトップへ