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」はちら見に便利。
早見表
| 要素 1 | 記法 | 表示 or 生成コード | 説明 |
|---|---|---|---|
| 見出し | #### 見出し4 #### #### 見出し4 ##### 見出し5 #### 見出し4 {#header4} [見出し4に戻る](#header4) |
【コード】 <h4 id=”header4″>見出し4</h4> |
|
| 段落 | 文章 文章 |
【コード】 |
前後に空行 |
| 強制改行 | 文章 文章 |
【コード】 |
半角スペース2つ入れて改行 |
| リンク その1 |
[リンク](http://bono.s206.xrea.com/ "power source*")です。 |
リンクです。 |
[リンク文字列](URI "タイトル") |
| リンク その2 |
[ホーム][home]、[webclip][1]へリンク。 [home]: http://bono.s206.xrea.com/ "power source*" [1]: http://bono.s206.xrea.com/webclip/ "power source* » webclip" |
| |
| リンク その3 |
<http://bono.s206.xrea.com/>
<dummy@example.jp>
|
http://bono.s206.xrea.com/ dummy@example.jp | URI ・メルアドでリンク。 |
| 画像 | 
![画像2][id2] |
|
画像が存在しないのでalt文字列が表示されてる。HTMLソース参照ということで。 |
| 強調 | ここで*強調*。 **さらに強調**です。 顔文字注意: (*’-'*) (\*’-'\*) |
ここで強調。 さらに強調です。 顔文字注意: (‘-’) (*’-'*) |
|
| 箇条書き | + 文章
+ 文章
+ 入れ子1
1. 入れ子2(番号付き)
1. 入れ子2
2. 入れ子2
+ 入れ子1
+ 文章 |
|
|
| 定義リスト |
りんご
: 果物だよ~
みかん
: これも
果物なんだよ~
: ○ンジュースとかもできるよ~ |
|
|
| コード (インライン) | 文章中に `<li>` タグを書く。 |
【コード】 |
|
| コード (ブロック) |
ブロック要素でコードを書くには
1行開けて
インデントして書く
Extraでは
~~~~~
3つ以上並べたチルダで
区切ってもOK
~~~~~ |
ブロック要素でコードを書くには
Extraでは
|
|
| 引用 | 以下、引用です。 > 自分が見やすいように > 改行してよし。 > (表示時に1文に繋がる) > > 表示上も改行するには > 強制改行とか段落とか > 使おう。 |
以下、引用です。
|
|
| 略語 | 略語を定義しておくと、文章中にHTMLが登場したときに abbrタグで括られる。 *[HTML]: Hyper Text Markup Language |
略語を定義しておくと、文章中にHTMLが登場したときに abbrタグで括られる。 |
|
| 脚注 | 脚注を入れるよ。[^1] [^footnote]
[^1]: 脚注の文章。
脚注の2段落目。
[^footnote]: IDは文字列でもok。
|
|
と、こんな感じで書いていってみようかと。
私は「表好き」なのだけれども、かえって見にくいかなあ。デモページの 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
+ 文章
|
|


[...] power source* [...]
[...] WP: PHP Markdown 記法早見表(的なもの) http://bono.s206.xrea.com/2007/01/312-markdown_syntax/ [...]
[...] WP: PHP Markdown 記法早見表(的なもの) WordPressにWiki記法(MarkDown)を導入したメモ [...]
[...] WP: PHP Markdown 記法早見表(的なもの) Tagged with: . No comments to this post. Username (required): [...]
[...] power source* » WP: PHP Markdown 記法早見表(的なもの) http://bono.s206.xrea.com/2007/01/312-markdown_syntax/ [...]
[...] power source* » WP: PHP Markdown 記法早見表(的なもの) Share and Enjoy: Posted in 未分類 | « 日誌20101022 You can leave a response, or trackback from your own site. [...]
[...] power source* » WP: PHP Markdown 記法早見表(的なもの) あたりを見れば十分です。 WordPressWordPress, プラグイン ← [SketchUp] [...]