にーやんのブログ

そもそも、私がMarkdownを使ってみようと思ったきっかけは、PukiWikiでのページ編集があまりにも楽だったことにあります。

PukiWikiと比較したときに、Blosxomでのエントリ書きが、すごく面倒なことに思えてきたんですね。

実際にMarkdownを使ってみた印象は、以下のような感じです:

• エントリを書くのが楽になった。

• ただし、あまり複雑な構造のエントリを書くのには向いていないかもしれない。

  • 例えば、画像、引用やリストなどを多用するようなエントリを書く場合に、なかなか思っていたような表示にならず、最初からHTMLで書けばよかったと思うことも・・・。
  • 単に慣れていないだけかもしれません。

• metaプラグインと連携させて、Markdownを使う場合とHTML形式で書く場合を使い分けたほうがいいように思う。

  • Markdownを使っていないエントリの誤変換も防げる。
  • ただし、最初からMarkdownを使ってBlosxomを始める場合は、この限りではない。

• プレビューできない。

  • これまでは、エントリの作成/編集時に、JavaScriptを使ったプレビュー機能を使っていたが、これが使えなくなった。
  • 現在は、ローカルでもBlosxomを動かして、プレビュー代わりにしている。

お手軽感ではWikiには及ばないものの（そもそも別物だし）、以前よりは、快適なブログ環境になったような気がします。

とりあえず、私は、Markdownをメインで使用し、場合によってHTML形式と使い分けるようにしようと思います。

なお、BlosxomにはWiki記法を利用できるプラグインもあるので、これらをMarkdown以外の選択肢として考えてもいいかもしれません。

• blosxom::yukiwiki
• yukiwikix plugin
• kwiki
• tiki

# Markdownとは？

MarkdownはテキストをHTMLに変換するためのツールだ。Markdownは可読性も高く、大変扱いやすいながらもXHTML（あるいはHTML）に準拠したソースを吐き出す。

Markdownの２つの特徴： (1) プレーンテキストフォーマットである；そして (2) Perlで書かれたプレーンテキストをHTMLに変換するソフトウェアである。

（“Markdownで記事を書こう”: Unmovabletypeから引用 ※ページ下部の追記を参照）

Markdownは、MovableTypeやBlosxomなどのプラグインとして、またコマンドラインからも利用可能です（Perl 5.6.0以降とDigest::MD5モジュールが必要）。

# Blosxomのプラグインとして使用する

Blosxom

Markdownは、Blosxom バージョン 2.0以降と一緒に動作します。

1. “Markdown.pl”プラグインを“Markdown”にリネームしてください（大文字小文字の区別は重要です）。Movable Typeは、プラグインが拡張子“.pl”を持つことを要求しますが、Blosxomは、それを禁止します。

2. “Markdown”プラグインを、あなたのBlosxomプラグインフォルダへコピーしてください。もし、あなたのBlosxomプラグインフォルダが、どこなのかわからないなら、参考までに、Blosxomのドキュメンテーションを見てください。

3. それで、おしまいです。あなたのウェブログのエントリは、Markdownによって自動的に処理されるでしょう。

4. もしあなたが、Markdownによる整形を、すべての投稿というよりもむしろ、一定の投稿にだけ適用したいなら、BlosxomのMetaプラグインと連携させることで、Markdownをオプションとして使用することができます。まず、Metaプラグインをインストールします。次に、Markdownプラグインのファイルをテキストエディタで開き、設定変数$g_blosxom_use_metaを1に設定します。あとは、単に、あなたがMarkdownを使って作る各投稿の一番最初に、“meta-markup: Markdown”というヘッダ行を含めるだけです。

（Daring Fireball: Markdownからの引用（適当訳））

簡単にまとめると、Markdown.plをMarkdown（拡張子なし）にリネームして、BlosxomのプラグインディレクトリにアップロードするだけでOK、ということです（上記1から3までの手順）。

あとは、自動的に、Markdownが、エントリをHTML（XHTML）形式に変換して表示してくれるようになります（エントリ自体が、実際にHTML形式に書き換えられてしまうわけではありません）。

ただし、この状態では、すべてのエントリがMarkdownの処理対象になります。たとえば、Markdown導入以前のエントリを変換してほしくないというような場合には、以下の方法（上記4の手順）をとる必要があります。

# 特定のエントリのみを対象としたい場合

Blosxomでは、metaプラグインと連携させることによって、特定のエントリのみをMarkdownの処理対象とすることができます。

metaプラグインと連携させる場合の手順

1. metaプラグインをBlosxomのプラグインディレクトリにアップロード。

2. Markdownプラグインをテキストエディタで開き、74行目（1.0.1の場合）のmy $g_blosxom_use_metaを1に変更。

   my $g_blosxom_use_meta = 1;

3. エントリ本文の1行目に、次の一文を記述する。

   meta-markup: Markdown

meta-markup: Markdownを書く場所

通常のエントリでは、1行目がタイトル、2行目以降が本文として扱われます。

1行目はタイトル
ここから本文

ここでいうエントリ本文の1行目とは、タイトルを除いた1行目のことです。

ここはタイトル
meta-markup: Markdown
これ以降は、Markdownで変換される

# 備考

meta-markup: Markdownと書いても、Markdownで変換されない場合

metaプラグインを、たとえば0metaとリネームして、Markdownより優先されるようにしてみてください。私の環境では、これを行わないと変換されずに、Markdown形式のテキストがそのまま表示されました。

---

（2005-01-28追記）
K-Jirow BLOG:UNMOVABLETYPEさん、閉鎖へによると、Unmovabletypeさんが閉鎖されたそうです。よって、上記のページを見ることはできません。

英語ですが、Daring Fireball: Markdown Syntax Documentationにて、Markdownのシンタックスについて知ることができます。

Markdown: DingusにあるMarkdownのシンタックスのリストの日本語訳。訳してないところや違う言葉に置き換えてるところがあるなど、いつものように適当。

シンタックス カンニングシート:

フレーズ強調

*斜体*   **太字**
_斜体_   __太字__

リンク
インライン:

[example](http://url.com/ "タイトル")

参照型ラベル（タイトルはオプション）:

[example][id]。それから、ドキュメントのどこか
他の場所に、リンクを定義する:

[id]: http://example.com/ "タイトル"

画像
インライン（タイトルはオプション）:


参照型:

![代替テキスト][id]

[id]: /URL/img.jpg "タイトル"

ヘッダ
Setextスタイル:

ヘッダ 1
========

ヘッダ 2
--------

atxスタイル（#で閉じるのはオプション）:

# ヘッダ 1 #

## ヘッダ 2 ##

###### ヘッダ 6

リスト
順序付けあり、段落なし:

1.  Foo
2.  Bar

順序づけなし、段落あり:

*   リストアイテム.

    多くの段落をはさんで

*   Bar

入れ子にすることもできる:

*   ぬるぽ
    * ガッ
*   ほげ
    1.  ほげ
    2.  ほげほげ
        * キター
    3. ほげほげほげ
*   お前もなー

引用

> Email風のかぎ括弧は
> 引用に使われる。

> > こうすれば、入れ子にもなる。

> #### 引用内ヘッダ
>
> * リストを引用することも可
> * などなど。

codeのスパン

`<code>`のスパンはバックティック（`）によって
範囲を規定されます。

バックティックを`` `この` ``ように
文字として含めることもできます。

プリフォーマットされたcodeブロック
codeブロックのすべての行は、少なくとも4つのスペースまたは1つのタブによってインデントされる

これは通常の段落。

    これはプリフォーマットされた
    codeブロック

水平方向の罫線
3つ以上のダッシュかアスタリスク:

---

* * *

- - - -

手動による行のブレーク
2つ以上のスペースでラインを終わりにする:

バラは赤い。   
すみれは青い。

Markdownのテスト用のエントリです。

Markdownは、こちらから。

• 行の最後に2つ以上のスペースを入れると、
  改行される。
• ＊（半角）＋スペースでリスト表示。
  • スペース＋＊＋スペースで入れ子構造。

ヘッダ

引用0

引用2

---

---

• a
  • b
  • c

<a href="http://niiyan.s8.xrea.com/blosxom/">test</a>

* test

カンガルーオアシス :: ブログとBBSを移転
突然ですが、このたび、ブログとBBSをXREAへ移転する事にしました。ブログトップに直リンクしてたり、ブログをRSSリーダーなどでみている方は、移転先に変更をお願いします。

Blosxom用のプラグイン「拡張スパムブロッカー」でお世話になっているカンガルーオアシスさんが、ブログとBBSを移転されました。というわけで、早速、Bloglinesの登録を移転先に変更しました。

ついでにコメントとトラックバックを分けて表示するようにしました。こちらについては、多分、やりたい人が多いと思いますので、後日、整理してエントリに上げる様にしたいと思います。

ということなので、こちらもちょっと期待してます。

（追記）このエントリの投稿後にトラックバックしてみましたが、うまく送れなかったみたいです。コメント欄とゲストブックにそのことを書こうとおもったら、拡張スパムブロッカーに弾かれました（c-ccエラー）。まだ、いろいろと調整中なのかもしれません。