シンタックスでんでんマークダウンの記法について解説します。拡張して、日本語と電子出版に最適化させたものです。Extraに由来する記法、でんでんマークダウン独自の記法が混在しています。マークダウン、というラベルをつけています。違いを把握する際の参考にしてください。マークダウンの執筆や表示の確認には、でんでんエディターが便利です。Extraでんでんマークダウン段落と段落の間には空行を挟みます。半角スペースやタブで字下げしないでください。書き方これは段落です。変換されるHTML<p>これは段落です。</p><p>これは別の段落です。/>を行ったものとして扱われます。これはでんでんマークダウンの大きな特徴です。書き方これは段落です。これは段落の続きです。変換されるHTML<p>これは段落です。/>これは段落の続きです。</p><p>これは別の段落です。改行は半角スペースに置き換えられます。/>を挿入するには、改行する箇所の手前に半角スペースを2つ以上挿入します。この方法は、視覚的に改行箇所を把握しづらく編集に不向きであるため、でんでんマークダウンでは採用していません。行頭の字下げ文芸作品のように、行頭を字下げする行としない行が登場し、しかも重要な意味を持つ作品では、字下げする行頭に全角スペースを入れるとよいでしょう。これは字下げする段落です。これは字下げしない段落です。これは字下げする段落です。</p><p>これは字下げしない段落です。挿入することで一行分の空きを作ることができます。これは空行の意味を解釈するのが難しい文芸作品向けの方法です。CSSに馴染みのある人は、margin、paddingをカスタマイズする方法も検討してください。書き方この段落の次が一行空きます。/></p>この段落の手前が一行空きます。Extraでんでんマークダウン見出しは半角のシャープ「#」を使って指定します。「#」の数によって<h1>から<h6>までの6段階のレベルを表します。######変換されるHTML<h1>見出しレベル1</h1><h2>見出しレベル2</h2><h3>見出しレベル3</h3><h4>見出しレベル4</h4><h5>見出しレベル5</h5><h6>見出しレベル6</h6>後ろの「#」は省略しても構いません。Extraでんでんマークダウン文字の下の行に半角のイコール「=」と半角のハイフンマイナス「-」を付けることで、それぞれ<h1>と<h2>の見出しを表現することもできます。見出しレベル1===========見出しレベル2-----------変換されるHTML<h1>見出しレベル1</h1><h2>見出しレベル2</h2>「=」や「-」は幾つ書いても構いません。Extraでんでんマークダウン半角不等号の「>」から始まる段落は引用になります。電子メールでお馴染みの記法ですね。「>」の後ろに半角スペースをひとつ入れると読みやすいです。書き方これは通常の段落です。これは引用された段落です。これも引用された段落です。これは通常の段落です。変換されるHTML<p>これは通常の段落です。<p>これは引用された段落です。<p>これも引用された段落です。</p></blockquote><p>これは通常の段落です。</p>「>」を重ねることで、引用の中の引用のように、入れ子構造を作ることができます。入れ子にできる数に制限はありません。これは引用された段落です。これは引用の中でさらに引用された段落です。これは引用の中の引用の中の引用の中でさらに引用された段落です。Extraでんでんマークダウン単純な箇条書きマーカーのついた単純な箇条書きは、行頭を半角のアスタリスク「*」、プラス記号「+」、ハイフンマイナス「-」のいずれかで始め、続けて半角のスペースを入れます。みかん変換されるHTML<ul><li>りんご</li><li>もも</li><li>みかん</li></ul>番号付きの箇条書き番号付きの箇条書きは、行頭を半角数字とピリオドから始め、続けて半角のスペースを入れます。みかん変換されるHTML<ol><li>りんご</li><li>もも</li><li>みかん</li></ol>使用する数値に関わらず、1から始まる箇条書きに変換されるので注意してください。次のように書いても変換結果は上記と同じです。みかん数値とピリオドから始まる段落が、意図せず番号付きの箇条書きに変換されてしまうことがあるかもしれません。これを避けるには、ピリオドの手前にバックスラッシュ「\」(Windowsでは半角円記号「¥」)を入力します。箇条書きの中にも、様々な内容を含めることができます。それぞれの項目の間に空行を挟むと、それぞれの項目は段落になります。これは箇条書きの中の段落です。これも箇条書きの中の段落です。変換されるHTML<ul><li><p>これは箇条書きの中の段落です。</p></li><li><p>これも箇条書きの中の段落です。</p></li></ul>項目に複数の段落を含めるには、続きの段落の行頭に半角スペースを4つ(またはタブをひとつ)入力します。これは箇条書きの中の最初の段落です。これは箇条書きの中の二番目の段落です。これは別の箇条書きの中の段落です。変換されるHTML<ul><li><p>これは箇条書きの中の最初の段落です。</p><p>これは箇条書きの中の二番目の段落です。</p></li><li><p>これは別の箇条書きの中の段落です。</p></li></ul>箇条書きに引用を含めるにも、行頭に半角スペースを4つ(またはタブをひとつ)入力します。これは箇条書きの中の最初の段落です。これは箇条書きの中で引用された段落です。これは別の箇条書きの中の段落です。変換されるHTML<ul><li><p>これは箇条書きの中の最初の段落です。</p><blockquote><p>これは箇条書きの中で引用された段落です。</p></blockquote></li><li><p>これは別の箇条書きの中の段落です。</p></li></ul>箇条書きの中にプログラムのコードを含めるには、行頭に半角スペースを8つ(またはタブを2つ)入力します。これは箇条書きの中の段落です。これは別の箇条書きの中の段落です。変換されるHTML<ul><li><p>これは箇条書きの中の最初の段落です。world.&lt;/p&gt;&lt;/body&gt;</code></pre></li><li><p>これは別の箇条書きの中の段落です。Extraでんでんマークダウンプログラムのコードの書き方には2種類あります。いずれも「&」や「<」「>」といった文字をそのまま表示できるように変換するので、特にHTMLのコードを書く上で便利です。プログラムのコードブロック複数行に渡るプログラムのコード(コードブロック)を表示するには、それそれの行を半角スペース4つ(またはタブひとつ)分字下げします。書き方これは通常の段落です。</body>これは別の段落です。変換されるHTML<p>これは通常の中の段落です。world.&lt;/p&gt;&lt;/body&gt;</code></pre><p>これは別の段落です。</p>変換時に字下げは除去されます。文中(インライン)のプログラムのコード文章の中で一行に収まるプログラムのコードを含めるには、コードを半角のバッククオート「`」で囲みます。段落には`<p>`タグを使います。変換されるHTML<p>段落には<code>&lt;p&gt;</code>タグを使います。Extraでんでんマークダウンでんでんマークダウンではこの記法の利用を推奨しません。これは通常、水平線として表示されます。これらの記号の間には、任意の半角スペースを入れても構いません。意味が定義しなおされ、前後で文脈が変化したことを意味するタグになりました。水平線を引くことを目的として、この記法を利用するのは適切とはいえません。改ページ(ファイル分割)でんでんマークダウンでんでんマークダウンでは半角のイコール記号「=」が3つ以上で構成される行があると、その前後でHTMLファイルを分割します。通常、ファイルを分割した箇所は改ページされます。EPUBは内容を複数のHTMLファイルに分割して作るのが一般的で、表示スピードも向上します。大見出しの手前など、本の内容に大きな区切りのある箇所に入れるとよいでしょう。書き方これは通常の段落です。##上記の例では大見出しから新しいHTMLファイルが始まります。改ページ(ファイル分割)を記述するときは、前後に空行を挟むようにしてください。段落に続けて改ページ(ファイル分割)を記述すると、見出しとして解釈されてしまうため、注意が必要です。ページ番号でんでんマークダウン印刷された本を元にEPUBを制作する場合に、紙の本のページ番号を記述する方法です。障がいを持つ人に向けて印刷された教科書の代わりとしてEPUBの電子教科書を提供するケースを想定しています。この情報を記述すると、Readiumのようにページリストナビゲーションをサポートするリーディングシステムでは、読者が紙のページ番号に相当する位置にジャンブできるようになります。ページ番号はそのページが始まる箇所に記述します。ページ番号だけが記述された行は<div>要素に変換されます。role="doc-pagebreak"></div><h2>大見出し</h2>この例ではページ番号は視覚的には表示されません。次に示すのは文章の途中で改ページがあった場合の記述方法です。文章の中に記述されたページ番号は<span>要素に変換されます。書き方これは途中で改ページ[%24]される段落です。role="doc-pagebreak"></span>される段落です。</p>ページ番号を視覚的に表示するにはページ番号の手前にパーセント記号を2つ付けます。role="doc-pagebreak">36</div><h2>大見出し</h2>ハイパーリンクハイパーリンクには幾つかの書き方があります。Extraでんでんマークダウンハイパーリンクにする文字列を半角の角括弧「[」「]」で囲み、続けてリンク先のURLを半角の丸括弧「(」「)」の中に書きます。詳しくは[こちら](http://example.com/)をごらんください。href="http://example.com/">こちら</a>をごらんください。</p>丸括弧の中のURLの後ろに半角スペースを入れ、半角のダブルクオート「"」に囲まれた文字列を入れると、その文字列はリンクのタイトルになります。通常、タイトルはリンクにマウスを重ねるとポップアップとして表示されます。"タイトル")をごらんください。title="タイトル">こちら</a>をごらんください。Extraでんでんマークダウンリンク先のURLをハイパーリンクにする文字列とは別の箇所に書く方法が、間接リンクです。同じURLを複数の箇所で参照する場合に便利です。ハイパーリンクにする文字列を半角の角括弧「[」「]」で囲み、続けてリンク先を特定するためのリンクID(任意の文字列)を、別の角の角括弧の中に書きます。リンク定義として文書の任意の箇所にリンクIDに対応したURLを書きます。詳しくは[こちら][example]をごらんください。http://example.com/変換されるHTMLは直接リンクの場合と同じです。リンク定義は表示されません。title="タイトル">こちら</a>をごらんください。間接リンクでは、リンク定義を文書の任意の箇所に書くことができますが、改ページ(ファイル分割)をまたぐことはできません。ハイパーリンクする文字列がリンク定義を参照できなくなります。リンク定義にもタイトルを付けることもできます。"タイトル"角括弧の中のリンクIDを省略すると、暗黙的にハイパーリンクにする文字列と同じものをリンクIDに指定したことになります。リンクIDには半角スペースを含めることができます。Fireball][]で公開されています。ExtraでんでんマークダウンURLとメールアドレスは半角の不等号「<」「>」で囲むと、自動的にハイパーリンクになります。メールアドレスはスパムよけのために、10進数と16進数の文字数値参照をランダムに組み合わせた形で表記されます。href="&#109;&#97;&#x69;&#108;&#116;&#111;:&#x69;&#110;&#x66;&#111;&#x40;&#101;&#120;&#97;&#109;&#112;&#x6C;&#101;&#x2E;&#99;&#111;m">&#x69;&#110;&#x66;&#111;&#x40;&#101;&#120;&#97;&#109;&#112;&#x6C;&#101;&#x2E;&#99;&#111;&#109;</a></p>Twitterアカウントでんでんマークダウンでんでんマークダウンでは半角の不等号「<」「>」で囲まれたTwitterアカウントもハイパーリンクにすることができます。私のTwitterアカウントは<@lost_and_found>です。href="http://twitter.com/lost_and_found">@lost_and_found</a>です。Extraでんでんマークダウン文章の中で、1つの半角アスタリスク「*」で囲まれた文字列は強調を意味するemタグで囲まれます。emタグは通常、イタリック体で表示されますが、でんでんコンバーターでは縦書きを選択した場合に限り、イタリック体にする代わりに圏点付きで表示します。文章の中で、2つの半角アスタリスクで囲まれた文字列は重要な語句を意味するstrongタグで囲まれます。strongタグは通常、ボールド体で表示されます。書き方これは*強調されたテキスト*です。これは**重要なテキスト**です。変換されたHTML<p>これは<em>強調されたテキスト</em>です。</p><p>これは<strong>重要なテキスト</strong>です。Extraでんでんマークダウンでんでんマークダウンではこの記法の利用を推奨しません。半角アスタリスク「*」の代わりに半角のアンダースコア「_」を利用しても同じことができます。これは_強調されたテキスト_です。これは__重要なテキスト__です。変換されたHTML<p>これは<em>強調されたテキスト</em>です。</p><p>これは<strong>重要なテキスト</strong>です。Extraとでんでんマークダウンでは単語の途中の「_」を強調に変換しません。"secret_magic_box".</p>しかし、これは単語をスペースで区切らない日本語の利用者にとっては、変換結果が予測しづらいです。なく「*」を利用することを推奨します。ルビでんでんマークダウンでんでんマークダウンでは複雑なHTMLのルビタグを平易な記法で記述できます。グループルビ文字列にまとめてルビをふるには、対象の文字列を半角中括弧「{}」で囲みます。次に文字列の後ろに半角のバーティカルバー「|」を入力し、続けてルビ文字を書きます。書き方{電子出版|でんししゅっぱん}を手軽に変換されたHTML<p><ruby>電子出版<rt>でんししゅっぱん</rt></ruby>を手軽に</p>モノルビ風の熟語ルビさらに、ルビ文字を半角のバーティカルバーで複数のまとまりに区切ると、それぞれの親文字にルビ文字を対応させることができます。親文字の文字数とルビ文字のまとまりの数が一致している必要があります。一致しない場合にはグループルビになります。書き方{電子出版|でん|し|しゅっ|ぱん}を手軽に変換されたHTML<p><ruby>電<rt>でん</rt>子<rt>し</rt>出<rt>しゅっ</rt>版<rt>ぱん</rt></ruby>を手軽に</p>でんでんマークダウンのルビの解釈条件は次のとおりです。「{}」や「|」を使ったプログラム言語や正規表現を記述する際に、誤変換を避ける上での参考にしてください。段落の中で「{」で始まり「|」以外の文字が一文字以上存在しその後ろに「|」が存在しその後ろに「|」以外の文字が一文字以上存在しその後ろに「}」が存在するパターン次のパターンは、「{」に続けて最初の「|」が存在するのでルビに解釈されません。