power source*

サイケデリックビビアンさんで紹介されていた PHP Markdown Extra を、試しに使い始めました。

前置き

• 私の目的はずばり、サンプルコードを書くときの実体参照への変換です。（狭！） WordPress にはクイックタグがあるので、XHTML で書くのは苦ではないのですが、実体参照への打ち直しは、コードが長くなるほど辛い・・・。
• それはさておき、マークダウン書式は、感覚的に合致した記号の使われ方なので、覚えやすく、XHTML タグを使って書いた記事よりも見やすい。
• XHTML タグと混在できる。全ての XHTML タグへ変換するためのものではなく、ベーシックなテキストを見やすく簡単に書くためのものなので。
• runPHP 等を使うためにビジュアルリッチエディタをオフして、XHTML と格闘している人にもおすすめ。²

導入手順

1. PHP Markdown と PHP Markdown Extra³ の2種類あるので、使いたいほうをダウンロードし、解凍。

2. デフォルトでは、記事とコメントの両方に Markdown が有効となっているが、無効にしたい場合は markdown.php の 34 or 35行目を修正。
   （例） コメントではマークダウンを無効にする。

   # WordPress settings:
   #
   $md_wp_posts    = true;  # Set to false to remove Markdown from posts.
   $md_wp_comments = false;  # Set to false to remove Markdown from comments.

3. markdown.php を wp-content/plugins/ ディレクトリへアップロード。
4. 管理画面にて有効化。
5. ビジュアルリッチエディタをオフにする。

使い方・メモ

• 記事投稿／ページ作成画面で、Markdown の書式で書く。
• backtick 「`」とは、Windows キーボードでいうと P キーのお隣、@ キーだ！
• XHTML タグで囲まれた部分はマークダウンが無効になるので、自力でタグ打ち & 実体参照置換。
• ただし、Extra では、ブロック要素タグ内でマークダウン可能。 cf. PHP Markdown Extra - Markdown Inside HTML Blocks
• CSS のために ul にクラスセレクタを付けたいのだけど、そのために ul タグを書くと、その中全部がマークダウン対象外になってしまう。Extra でも、中にもう1組 ul が作られてしまうし・・・。(;_;) div とか td の中は OK なのになあ。

Markdown 書式 参考ページ

• PHP Markdown: Concepts — 配布元による文法紹介。
• PHP Markdown Extra — Extra 独自部分
• Daring Fireball: Markdown Syntax Documentation — さらに詳しくはココ。オリジナル Markdown の作者 John Gruber 氏によるページ。改めて感謝。
• PHP Markdown: Dingus — デモは 変換後の XHTML ソースが見られて便利⁴。 Syntax Cheatsheet はちら見に便利。
• 日本語解説
  • Unmovabletype » Markdown文法紹介 — 日本語での説明がありがたい。オリジナル Perl 版 Markdown の紹介だけど、書き方は基本的に同じ。
  • Future is Now » Memo » Markdown記法 追記 — Extra 独自部分も網羅。

1. ビジュアルリッチエディタの替わりにできるプラグインな訳で。。。[back]
2. うちの使っているプラグインリストに載っているものとは併用できている。[back]
3. Extra は ブロック要素タグ内のマークダウン、<dl> 、テーブル等をサポート。 cf. PHP Markdown Extra description。デモページで両方試せる。[back]
4. どのような XHTML が生成されるかは、WordPress 上では、記事を保存してプレビューしてソースを見ないと分からないので。[back]

関連ページ

• WP: PHP Markdown 記法早見表（的なもの）
• WP plugin[up]: 簡易記法で記事を書く - PHP Markdown Extra をアップグレード
• WP plugin: 実体参照へ変換 - DeCoder
• WP: 使っているプラグイン 逆引き（機能別）リスト