{{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.

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

日本語見出し

バージョン0.5.8で確認。 !! コマンドラインからの実行で、日本語を含むファイルを正常に変換できないバージョン0.5.8で確認。marukuコマンドの実行時には文字コードの指定ができない（文字コードを指定するためのオプションがない）ため、文字化けを起こす。