Markdown記法について
===============

OlivineEditorはMarkdown記法のプレビュー機能を搭載しています。
OEでは編集対象をプレーンテキストに限定しているため、Word等のエディタのように文中に画像を挿入したり文字スタイルを変更することができませんが、代わりにMarkdownを用いて修飾することができます。  
このマニュアルはMarkdown記法で書かれています。C-pで変換後の状態がプレビューできます。


Markdownとは
----------------

プレーンテキストで一定の規則に沿って文章を書くと、それを自動でHTMLに変換してくれるフォーマットです。
一部のブログサービス（Tumblr等）はMarkdownをサポートしているので、OEでのメモ書きをそのまま投稿するだけで整った体裁で公開することができます。また、OEでMarkdownのHTML出力を実装しているので、その他のブログやホームページ上のコンテンツ作成にも便利です。  
ベタ書きのHTMLタグも反映されるので、ちょっとしたHTML/cssのチェックにも使えます。


プレビューについて
-----------------

C-pまたは上部メニューのプレビュー内の「MarkdownプレビューのON/OFF」からプレビュー画面とプレーンテキスト画面の切り替えが可能です。  
C-S-pまたは上部メニューのプレビュー内の「MarkdownとしてHTML出力」で変換後のHTMLタグが出力できます。  


文法について
---------------

Wikipediaに概略が記載されています。  
<http://ja.wikipedia.org/wiki/Markdown>

また、こちらのサイトにMarkdown開発者による詳細な解説の日本語版があります。  
<http://blog.2310.net/archives/6>

このノードの子に簡単なサンプルを用意したので参考にしてください。


プレビューの詳細仕様
----------------

アプリと同じディレクトリにあるpreview.cssをカスタムすることで表示されるスタイルを変更できます。
ただし、swingのHTML/cssパーサがたいへん貧弱なので、ごく簡単なcssしか表示できないようです。
例えば、ボーダーの表示はできません。margin:autoを用いた中央寄せもできません。背景色の変更はできますが、色名では反応せず、カラーコードで書いてあげないといけません。
あくまで目安としてのプレビューと割りきってください。

表示されるHTMLは以下の通りです。

    <html>
      <head>
        <style type="text/css">
            preview.cssの内容
        </style>
      </head>
      <body>
        <div id="markdown-view">
            変換されたMarkdown
        </div>
      </body>
    </html>