{{outline}} !!! 概要 [Markdown Extra|http://michelf.com/projects/php-markdown/extra/]の拡張文法と、それとは別に独自の拡張文法を実装した、高機能なMarkdownパーサ。出力にはXHTMLのほか、LaTeX形式やPDF形式なども選択できる。また、一つのMarkdownテキストファイル（拡張子 .md ）を、完全なXHTML文書（DOCTYPE宣言やhead部まで含む）に変換できる機能がある。 ::公式サイト :::http://maruku.rubyforge.org/ !!! 基本的な使い方 [公式サイトのUsage|http://maruku.rubyforge.org/usage.html]を参考にまとめています。 !! ライブラリとして使う基本的には[[BlueCloth]]と変わらないが、to_html_documentという新しい変換メソッドがある。 require 'maruku' text = <Test Document

This is body.

! to_html_documentの場合の出力 Test Document

Test Document

This is body.

!! コマンドラインから使う次のように打ち込むと、file.mdをfile.htmlに変換する。 $ maruku file.md また、次のように打ち込むと、pdflatexコマンドを使ってLaTeX→PDFに変換してから出力する（file.texとfile.pdfができる）。 $ maruku --pdf file.md !!! Maruku独自拡張（執筆者募集） !!! 問題点 !! 見出しに日本語などを使うと、idがXMLの仕様に違反した値になる日本語見出し ============

日本語見出し

バージョン0.5.8で確認。 !! コマンドラインからの実行で、日本語を含むファイルを正常に変換できないバージョン0.5.8で確認。marukuコマンドの実行時には文字コードの指定ができない（文字コードを指定するためのオプションがない）ため、マルチバイト文字を含んでいると文字化けを起こす。 !! 行の空いていない入れ子リストを解釈しない次のようなリストは、[[BlueCloth]]では入れ子リストにしてくれるのに対し、Maruku0.5.8では入れ子にならない。 * Item-1 * Item-2 * Item-2-1 * Item-3 次のように書くと、Marukuでも入れ子リストになる。 * Item-1 * Item-2 * Item-2-1 * Item-3 とはいえ、入れ子リストは[Markdown Syntax|http://daringfireball.net/projects/markdown/syntax.php]で仕様として明記されてはいる書き方ではないので、これを問題点と見るべきかどうかは微妙なところ。 !! インライン要素としてのHTMLタグを解釈しない * 強調したい文字列 これはBlueClothにおいては強調と解釈されるが、Marukuではそうならない。