【至急・重要】ウィルスチェックのお願い


WP: PHP Markdown 記法早見表(的なもの)

update 8.25: ちょっと更新。

さて、手放せないプラグイン第一位に躍り上がった PHP Markdown Extraですが、初回導入時にリストアップした日本語解説ページが軒並み見られなくなってしまったので、自分で簡単にメモ。私がよく使うテンプレートタグや他のプラグインとの連携についてもコメント。

ぼののは和訳ではないので、正しく/詳しくは以下を参照。

  • PHP Markdown: Concepts — 配布元による文法紹介。
  • Daring Fireball: Markdown Syntax Documentation — さらに詳しくはココ。オリジナルMarkdownの作者 John Gruber氏によるページ。改めて感謝。
  • PHP Markdown Extra — Extra独自部分
  • PHP Markdown: Dingus — デモ。変換後のXHTMLソースが見られて便利。どのようなXHTMLが生成されるかは、WordPress上では、記事をプレビューしてソースを見ないと分からないので。
    「Syntax Cheatsheet」はちら見に便利。

早見表

PHP Markdown Extra
要素 1記法表示 or 生成コード説明
見出し #### 見出し4 ####
#### 見出し4
##### 見出し5

#### 見出し4 {#header4}

[見出し4に戻る](#header4)

【コード】
<h4>見出し4</h4>
<h4>見出し4</h4>
<h5>見出し5</h5>

<h4 id=”header4″>見出し4</h4>

見出し4に戻る

段落
文章

文章

【コード】
<p>文章</p>
<p>文章</p>

前後に空行
強制改行
文章  
文章

【コード】
文章<br />
文章

半角スペース2つ入れて改行
リンク
その1
[リンク](http://bono.s206.xrea.com/ "power source*")です。

[ページ内リンク](#note)

リンクです。

ページ内リンク

[リンク文字列](URI "タイトル")
リンク
その2
[ホーム][home]、[webclip][1]へリンク。

[home]: http://bono.s206.xrea.com/ "power source*"
[1]: http://bono.s206.xrea.com/webclip/ "power source* &raquo; webclip"

ホームwebclip へリンク。

  • 文章とは別の位置にまとめて定義。ID は数字でも文字列でも。
  • 定義は [ID]: URI "タイトル"
  • 文章が見やすい。本文内で使い回しできる。
リンク
その3
<http://bono.s206.xrea.com/> <dummy@example.jp> http://bono.s206.xrea.com/ dummy@example.jp URI ・メルアドでリンク。
画像 ![Alt 文字列](/画像へのパス/img.jpg “title属性の値”)

![画像2][id2]

[id2]: /画像2へのパス/img2.jpg “title属性の値”

Alt 文字列

画像2

画像が存在しないのでalt文字列が表示されてる。HTMLソース参照ということで。
強調

ここで*強調*。
ここで_強調_。

**さらに強調**です。
__さらに強調__です。

顔文字注意: (*’-'*) (\*’-'\*)

ここで強調

さらに強調です。

顔文字注意: (‘-’) (*’-'*)

  • * (アスタリスク)か _ (アンダースコア)で囲む。2つで <strong>
  • うちは両方とも太字なので見分けつかないが。(^^;
  • * とかの記号を表示するには
箇条書き
+ 文章
+ 文章
    + 入れ子1
        1. 入れ子2(番号付き)
        1. 入れ子2
        2. 入れ子2
    + 入れ子1
+ 文章
  • 文章
  • 文章
    • 入れ子1
      1. 入れ子2(番号付き)
      2. 入れ子2
      3. 入れ子2
    • 入れ子1
  • 文章
  • 番号なし: 記号は * か + か -
  • 番号付き: 数字+ピリオド。数値は問わないけど素直に振ったほうが自分が分かりやすかろう。
  • 入れ子にするには、タブまたは4スペース。
  • 番号なし・番号付きの相互入れ子OK。
定義リスト
りんご
: 果物だよ~

みかん
:   これも
    果物なんだよ~
:   ○ンジュースとかもできるよ~
りんご
果物だよ~
みかん
これも 果物なんだよ~
○ンジュースとかもできるよ~
コード (インライン) 文章中に `<li>` タグを書く。

【コード】
文章中に <code><li></code> タグを書く。

  • コード部分をバックチック(`)[^backtick] で囲む。
  • 実体参照で書くべき文字も自動変換してくれる。
コード (ブロック)
ブロック要素でコードを書くには

    1行開けて
    インデントして書く

Extraでは

~~~~~
3つ以上並べたチルダで
区切ってもOK
~~~~~

ブロック要素でコードを書くには

1行開けて
インデントして書く

Extraでは

3つ以上並べたチルダで
区切ってもOK
引用
以下、引用です。

> 自分が見やすいように
> 改行してよし。
> (表示時に1文に繋がる)
> 
> 表示上も改行するには  
> 強制改行とか段落とか  
> 使おう。

以下、引用です。

自分が見やすいように 改行してよし。 (表示時に1文に繋がる)

表示上も改行するには
強制改行とか段落とか
使おう。

略語
略語を定義しておくと、文章中にHTMLが登場したときに abbrタグで括られる。

*[HTML]: Hyper Text Markup Language

略語を定義しておくと、文章中にHTMLが登場したときに abbrタグで括られる。

脚注
脚注を入れるよ。[^1] [^footnote]

[^1]: 脚注の文章。

    脚注の2段落目。

[^footnote]: IDは文字列でもok。

脚注を入れるよ。3 4

  • IDは数字でも文字列でも。
    脚注側のid属性・リンクURLに使われる。詳しくはHTMLソース参照。
  • 脚注番号は登場順に振り直される。
  • 脚注リンクのtitle 属性・class属性の文字列は、markdown.php 内の定数 MARKDOWN_FN_○○ でカスタム可能。
    define( 'MARKDOWN_FN_LINK_TITLE', "脚注 %% に飛ぶ" );
    (%% は脚注番号に置き換わる)

と、こんな感じで書いていってみようかと。 Σ(゜д゜lll) 書き途中なんだ!?
私は「表好き」なのだけれども、かえって見にくいかなあ。デモページの Syntax Cheatsheet の和訳でもいいような気もしてきたし。。。orz

  • &、<、>、’ は、何もしなくても自動的に文字実体参照に置き換えてくれる。
  • Markdown で使う記号をそのまま表示したいときは、その記号の前に「\」バックスラッシュ(「ろ」キーんとこ)。
  • ベーシックなテキストを見やすく簡単に書くためのものなので、複雑な文法や、CSS用のclass属性を付けられなかったりする。が、xHTMLタグと併用できるので、部分的にHTMLタグを使えばよい。
  • xHTMLタグで囲まれた内側は、markdown記号は無効。 Extraでは有効にできる
    • <p markdown="1">「強調」などインライン要素のマークアップが使える</p>
    • <div markdown="block">段落や箇条書きなどブロック要素のマークアップも使える</div>
  • 慣れないうちは、クイックタグに入れておくのも手。

合わせ技

記法表示 or 生成コード
その1
+ 文章
+ 文章  
強制改行
    + 入れ子1
        1. 入れ子2(番号付き)
        2. 入れ子2
    + 入れ子1
    
    段落
    
    > 引用  
    > 引用
    
        コードブロック abcde
        コードブロック 01234
+ 文章
  • 文章
  • 文章
    強制改行

    • 入れ子1
      1. 入れ子2(番号付き)
      2. 入れ子2
    • 入れ子1

    段落

    引用
    引用

    コードブロック abcde
    コードブロック 01234
    
  • 文章

  1. 要素名をクリックすると PHP Markdown/Extra 原文へ飛ぶ。 

  2. 「たいていのテーマでは、アーカイブページ等で h3 が記事タイトルに使われるので、h4 がおすすめ」(意訳)と Codex に載っていた。 

  3. 脚注の文章。

    脚注内の2段落目。 

  4. IDは文字列でもok。 

YOU、これも読んじゃないなYO!

  • No Related Posts

7 Responses to “WP: PHP Markdown 記法早見表(的なもの)”

コメントをどうぞ

ファイルアップロード

画像やファイルをコメント内に表示できます。ファイルを選ぶと、このサイトのサーバにアップロードされ、コメント欄にリンクが挿入されます。ファイルは複数アップロードできます。

  • あなたのコンピュータ上のファイル名がそのまま使われます。
  • アップロードするファイルを間違えたたときは、URLの行を削除して、ファイル名を教えてください。コメントには表示されません。
  • 他の人の著作物は勝手にアップしちゃダメだよー。


※ XREA無料サーバのため広告表示が義務となっています。お許しを。。