電電轉換器

從入門者到高手都能滿足,輕輕鬆鬆就能做出高品質的EPUB 3

接下來說明電電 Markdown 的記述方法。

電電 Markdown 的記述方法(DDmd記法)是由 Markdown 方言中的 PHP Markdown Extra 加以擴張而生,針對中文、日文與數位出版最佳化的產物。也因為如此,原生的 Markdown 記法、從 PHP Markdown Extra 而來的記法和電電 Markdown 原生的記法相互並存。

為了彼此做出區別,下面的解說分別附加標籤,原生的 Markdown 所使用的記法以 Markdown、PHP Markdown Extra 也使用的記法以 PHP Markdown Extra、電電 Markdown 特有的記法為 電電 Markdown。當想了解差異時,可以此作為參考。

段落

  • Markdown
  • PHP Markdown Extra
  • 電電 Markdown

段落與段落之間請以空行分隔。請勿加入半型或全型空白,以及Tab縮排。

書寫方式

這是段落。

這是另一個段落。

轉換後的HTML

<p>這是段落。</p>

<p>這是另一個段落。</p>

段落內的換行

  • 電電 Markdown

文章若想於換行後,不加入空行文章繼續排列的話,就等同於段落的 <p> 中,加入換行標籤 <br />來進行處理。這是電電 Markdown 的重要特色。

書寫方式

這是段落。
這是同一段落的延續。

這是另一個段落。

轉換後的HTML

<p>這是段落。<br />
這是同一段落的延續。</p>

<p>這是另一個段落。</p>

原生的 Markdown 與 PHP Markdown Extra 是將半型空白置換為換行標籤 <br /> 。若以該方式處理,就需於要換行的位置前加入兩個以上的半型空白。由於這個方法於很難以視覺化掌握換行位置,所以並不適合編輯使用,故電電 Markdown 不予採用。

段首縮排

文藝作品中,有的段首會縮排,有的則不會縮排。若段首縮排有其重要意涵的話,請在要縮排的段首加入全型空白即可。

書寫方式

  這是縮排的段落。

這是不縮排的段落。

轉換後的HTML

<p>  這是縮排的段落。</p>

<p>這是不縮排的段落。</p>

標題

使用 # 的記法atx格式

  • Markdown
  • PHP Markdown Extra
  • 電電 Markdown

標題設定請使用半型的井號「#」指定。依照「#」的數量,分別對應到 <h1> 起到 <h6> 為止六段標題層級。

書寫方式

# 標題層級1 #

## 標題層級2 ##

### 標題層級3 ###

#### 標題層級4 ####

##### 標題層級5 #####

###### 標題層級6 ######

轉換後的HTML

<h1>標題層級1</h1>

<h2>標題層級2</h2>

<h3>標題層級3</h3>

<h4>標題層級4</h4>

<h5>標題層級5</h5>

<h6>標題層級6</h6>

後方的「#」就算省略也沒有關係

### 標題層級3

使用 = - 的記法 setext格式

  • Markdown
  • PHP Markdown Extra
  • 電電 Markdown

你也能在文字下面那一行加上半型等號「=」或半型減號「-」,就會分別對應到 <h1> 與 <h2> 的標題層級。

書寫方式

標題層級1
===========

標題層級2
-----------

轉換後的HTML

<h1>標題層級1</h1>

<h2>標題層級2</h2>

「=」及「-」的數量不造成影響

標題層級1
==

標題層級2
---------------------------

引用

  • Markdown
  • PHP Markdown Extra
  • 電電 Markdown

以半型大於符號「>」開始的段落就會視為引用段落。這是E-mail常見的記法。若於「>」後面加上半型空白會更容易閱讀。

書寫方式

這是通常的段落。

> 這是引用的段落。
>
> 這也是引用的段落。

這是通常的段落。

轉換後的HTML

<p>這是通常的段落。</p>

<blockquote>
  <p>這是引用的段落。</p>

  <p>這也是引用的段落。</p>
</blockquote>

<p>這是通常的段落。</p>

若重複使用「>」的話,就會如引用中的引用一般,成為巢狀結構。巢狀結構沒有層級限制。

> 這是引用的段落。
> > 這是引用之中更進一步引用的段落。
> > > > 這是引用之中的引用之中的引用之中更進一步引用的段落。

列表(List)

  • Markdown
  • PHP Markdown Extra
  • 電電 Markdown

簡單的列表

加上符號的簡單列表,僅需於行首加上半型星號「*」、加號「+」、減號「-」等,接著半型空白就行。

書寫方式

* 蘋果
* 桃子
* 橘子

或者是

+ 蘋果
+ 桃子
+ 橘子

或者是

- 蘋果
- 桃子
- 橘子

轉換後的HTML

<ul>
<li>蘋果</li>
<li>桃子</li>
<li>橘子</li>
</ul>

有編號的列表

有編號的列表則於行首以半型數字與句號(Period)「.」開始,後接半型空白即可。

書寫方式

1. 蘋果
2. 桃子
3. 橘子

轉換後的HTML

<ol>
<li>蘋果</li>
<li>桃子</li>
<li>橘子</li>
</ol>

不管你使用任何數值,都會轉換成從1開始的編號列表,請多加注意,就算以以下方式書寫,轉換後的結果都會與上記相同。

3. 蘋果
1. 桃子
8. 橘子

以數字與「.」開始的段落,也有可能不小心轉換成有編號的列表。為了避免這種狀況發生,請於「.」前加上斜線「\」來迴避。

1986\. What a great season.

列表書寫的內容

列表中也能包含各式各樣的內容。

只要於個別項目之間加上空行,彼此就會以段落進行區分。

書寫方式

* 這是列表書寫中的段落。

* 這也是列表書寫中的段落。

轉換後的HTML

<ul>
<li><p>這是列表書寫中的段落。</p></li>
<li><p>這也是列表書寫中的段落。</p></li>
</ul>

項目中若有著複數的段落,請於次一段落的行首前加上四個半型空白(或者一個Tab)。

書寫方式

* 這是列表書寫中最初的段落。

    這是列表書寫中第二個段落。

* 這是列表書寫中其他的段落。

轉換後的HTML

<ul>
<li><p>這是列表書寫中最初的段落。</p>

<p>這是列表書寫中第二個段落。</p></li>
<li><p>這是列表書寫中其他的段落。</p></li>
</ul>

書寫時若要加入引用的話,也請於行首加上四個半型空白(或者一個Tab)。

書寫方式

* 這是列表書寫中最初的段落。

    > 這是列表書寫中引用的段落。

* 這是列表書寫中其他的段落。

轉換後的HTML

<ul>
<li><p>這是列表書寫中最初的段落。</p>

<blockquote>
<p>這是列表書寫中引用的段落。</p>
</blockquote></li>
<li><p>這是列表書寫中其他的段落。</p></li>
</ul>

列表書寫時若要加入程式碼的話,也請於行首加上八個半型空白(或者二個Tab)。

書寫方式

* 這是列表書寫中最初的段落。

        <body>
          <p>Hello world.</p>
        </body>

* 這是列表書寫中其他的段落。

轉換後的HTML

<ul>
<li><p>這是列表書寫中最初的段落。</p>

<pre><code>&lt;body&gt;
  &lt;p&gt;Hello world.&lt;/p&gt;
&lt;/body&gt;
</code></pre></li>
<li><p>這是列表書寫中其他的段落。</p></li>
</ul>

程式碼

  • Markdown
  • PHP Markdown Extra
  • 電電 Markdown

程式碼有兩種書寫方式。

不管是哪一種,像「&」及「<」「>」這樣的文字都能夠轉換成與原本一樣的呈現樣貌,特別於書寫HTML程式碼上相當方便。

程式碼區塊

若要呈現跨複數行的程式碼(程式碼區塊)的話,請於每一行前加入4個半型空白(或者1個Tab)縮排。

書寫方式

這是一般的段落。

    <body>
      <p>Hello world.</p>
    </body>

這是其他的段落。

轉換後的HTML

<p>這是一般的段落。</p>

<pre><code>&lt;body&gt;
  &lt;p&gt;Hello world.&lt;/p&gt;
&lt;/body&gt;
</code></pre>

<p>這是其他的段落。</p>

轉換時會自動刪除空白縮排。

文章中(inline)的程式碼

文章中若有著能收於一行內的程式碼時,請以半型的「`」符號包住該程式碼。

書寫方式

段落則使用 `<p>` 標籤。

轉換後的HTML

<p>段落則使用<code>&lt;p&gt;</code>標籤。</p>

水平線

  • Markdown
  • PHP Markdown Extra
  • 電電 Markdown
電電 Markdown 並不推薦採用本記法。

以三個以上的半型減號「-」、星號「*」、底線「_」所構成的行,就會自動轉換成 <hr />標籤。該標籤通常會呈現為水平線。這些記號之間就算隨便加入半型空白也沒關係。

書寫方式

* * *

***

*****

---

---------------------------------------

- - -

無論是哪一種都會轉換成以下的HTML

<hr />

注意

EPUB中所使用的 <hr /> 於HTML5中重新定義其意義,而成為其前後文脈有著變化意涵的標籤。

雖然目的上是為了加上水平線,但使用這項記法並不能說相當適切。

換頁(檔案分割)

  • 電電 Markdown

電電 Markdown 中若有著三個以上半行等號「=」構成的行時,就會將其前後分割為不同的HTML檔案。通常,檔案分割之處也會進行換頁。

EPUB一般會將內容分隔為複數HTML檔案,以讓開啟、呈現速度變快。建議於大標之前、或者書籍內容有著大幅區隔之處加入這標記。

書寫方式

這是一般的段落。

=======================================

## 大標 ##

以上面的範例,就會由大標處作為新的HTML檔案開頭。

注意

記述換頁(檔案分割)時,其前後請以空行夾住。

同時,段落延續時若以換頁(檔案分割)記述的話,後面就會被視為標題轉換,所以需要多加注意。

頁碼

  • 電電 Markdown

這是將印刷紙書作為底本製作EPUB時,記述紙書頁碼的標記方式。主要想像的應為,以EPUB電子教科書取代印刷教科書提供給障礙者時所使用。

若擁有這項訊息的話,在如Readium這樣支援頁面清單導覽的閱讀系統上,讀者就能直接跳到紙書頁面的相對位置。

頁碼請於記述於該頁開始之處。僅記述頁碼的那一行,就會轉換成元素。

書寫方式

[%5]

## 大標 ##

轉換後的HTML

<div id="pagenum_5" class="pagenum" title="5" epub:type="pagebreak" role="doc-pagebreak"></div>

<h2>大標</h2>

這案例中所記的頁碼不會有任何視覺呈現。

下所示為文章進行中途遇到換頁時的記述方法。文章中所記述的頁碼會轉換為 <span> 元素。

書寫方式

這是中途遇到換頁[%24]的段落。

轉換後的HTML

<p>這是中途遇到換頁<span id="pagenum_24" class="pagenum" title="24" epub:type="pagebreak" role="doc-pagebreak"></span>的段落。</p>

若希望頁碼能有視覺呈現的話,請將頁碼前面的百分比記號加為2個。

書寫方式

[%%36]

## 大標 ##

轉換後的HTML

<div id="pagenum_36" class="pagenum" title="36" epub:type="pagebreak" role="doc-pagebreak">36</div>

<h2>大標</h2>

超連結有著幾種書寫方式。

直接連結

  • Markdown
  • PHP Markdown Extra
  • 電電 Markdown

將要加上超連結的文字列以半型方括弧「[」、「]」圍繞,接著要連結的URL寫於半型圓括弧「(」、「)」之中。

書寫方式

詳細請參考[這裡](http://example.com/)。

轉換後的HTML

<p>詳細請參考<a href="http://example.com/">這裡</a>。</p>

圓括弧中,URL後面若加入半型空白,以及半型「"」所夾住的文字列,該文字列就會成為連結的標題。通常,標題於滑鼠移到連結上時就會以Pop-up方式表現。

書寫方式

詳細請參考[這裡](http://example.com/ "標題")。

轉換後的HTML

<p>詳細請參考<a href="http://example.com/" title="標題">這裡</a>。<p>

間接連結

  • Markdown
  • PHP Markdown Extra
  • 電電 Markdown

間接連結是將URL與被連結的文字列寫於其他地方的方法。若相同URL出現於複數位置時,比照會更為方便。

將要加上超連結的文字列以半型方括弧「[」、「]」圍繞,接著將用來標示特定連結的連結ID(任何文字),記入另一個半型方括弧中。接著,對應連結ID的URL記述於文件中任何位置皆可。

書寫方式

詳細請參考[這裡][example]。

[example]: http://example.com/

轉換後的HTML與直接連結相同,並不會呈現連結定義。

<p>詳細請參考<a href="http://example.com/">こちら</a>。<p>

警告

間接連結雖然能夠將連結定義寫於文件中的任何位置,但是卻不能超出換頁(檔案分割)的範圍之外。不然的話,超連結文字列無法找到對應的連結定義,造成連結失效。

連結定義也能夠加上標題。

書寫方式

[example]: http://example.com/ "標題"

若省略方括弧中的連結ID的話,預設是將要加上連結的文字列直接作為連結ID使用。此外,連結ID中也能夠包含半型空白。

書寫方式

原創的Markdown語法公開於[Daring Fireball][]網站上。

[Daring Fireball]: http://daringfireball.net/

自動連結

URL與E-Mail位址

  • Markdown
  • PHP Markdown Extra
  • 電電 Markdown

若將URL與E-mail位址以半型不等號「<」、「>」包覆,就會自動被視為超連結。E-mail為了避免垃圾郵件攻擊,而會採10進位與16進位的文字數值,以亂數方式記述。

書寫方式

<http://example.com>

<[email protected]>

轉換後的HTML

<p><a href="http://example.com">http://example.com</a></p>

<p><a 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帳號

  • 電電 Markdown

電電 Markdown 中會自動將以半型不等號「<」、「>」所包覆的 Twitter 帳號直接當作超連結轉換。

書寫方式

我的Twitter帳號是<@lost_and_found>。

轉換後的HTML

<p>我的Twitter帳號是<a href="http://twitter.com/lost_and_found">@lost_and_found</a>。</p>

文字強調

使用 * 的記法

  • Markdown
  • PHP Markdown Extra
  • 電電 Markdown

文章中以單獨半型星號「*」包圍的文字列,會以具有強調意涵的 em 標籤包圍。一般來說 em 標籤會以斜體呈現。

文章中以兩個半型星號「*」包圍的文字列,會以視為重要語句的 strong 標籤包圍。一般來說 strong 標籤會以粗體呈現。

書寫方式

這一段是*需要強調*的文字。

這一段是**重要**的文字。

轉換後的HTML

<p>這一段是<em>需要強調</em>的文字。</p>

<p>這一段是<strong>重要</strong>的文字。</p>

使用 _ 的記法

  • Markdown
  • PHP Markdown Extra
  • 電電 Markdown
電電 Markdown 並不推薦採用本記法。

「*」也可以使用半型底線「_」來取代半型星號,達到相同的效果

這一段是_需要強調_的文字。

這一段是__重要__的文字。

轉換後的HTML

<p>這一段是<em>需要強調</em>的文字。</p>

<p>這一段是<strong>重要</strong>的文字。</p>

使用 _ 記法之例外

  • PHP Markdown Extra
  • 電電 Markdown

PHP Markdown Extra 與 電電Markdown 不會將單字中的「_」轉換成強調標籤。

書寫方式

Please open the folder "secret_magic_box".

轉換後的HTML

<p>Please open the folder "secret_magic_box".</p>

但是這對於字詞間不以空白作為區分的中文、日文使用者來說,難以預測轉換後的結果。所以若要標記強調以及重要性的話,建議不要使用「_」,而使用「*」來進行標記

Ruby 文字

  • 電電 Markdown

電電 Markdown 能夠將複雜的 HTML Ruby 標籤,以平易的記法來記述。

Group Ruby

若要在整個文字列上加上 Ruby 的話,請將要加上 Ruby 的文字列以半型中括弧「{}」圍繞。之後於文字列後面加上半型垂直線「|」,接著輸入 Ruby 文字。

書寫方式

{我愛你|I love you}一生一世

轉換後的HTML

<p><ruby>我愛你<rt>I love you</rt></ruby>一生一世</p>

Mono Ruby 風格的熟語 Ruby

更進一步,若將 Ruby 文字以半型垂直線切割為複數的話,就會對應到分別的主文字之上。

主文字的文字數與 Ruby 文字的切分數需要一致。若不一致時,會以 Group Ruby 來處理。

書寫方式

{我愛你|I|love|you}一生一世

轉換後的HTML

<p><ruby>我<rt>I</rt>愛<rt>love</rt>你<rt>you</rt></ruby>一生一世</p>

電電 Markdown 的 Ruby 轉譯條件如以下所示。若有程式語言將「{}」與「|」作為正規記述方式時,可作為避免誤轉換時的參考。

  • 段落中由「{」開始的
  • 除了「|」以外,還有一個以上的文字存在
  • 其後有著「|」存在
  • 其後有著「|」以外,一個以上的文字存在
  • 其後有著「}」存在的模式

以下模式,於「{」後直接接續著「|」,所以不會轉換成 Ruby。

這是段落。foo{|bar| bar.buz} 這是段落。

若要確實地避免轉換成 Ruby 的話,於前方加入「\」就能避開轉換。

這是段落。\{Info\|Warning\} 這是段落。

最低限度就是在「|」前加上「\」,就能夠避開 Ruby 的轉換規則

這是段落。。{Info\|Warning} 這是段落。

若整體以程式碼用符號「`」包覆時,也能夠避開 Ruby 的轉換規則。

這是段落。`{Info|Warning}` 這是段落。

縱中橫排

  • 電電 Markdown

直排文章中,特定文字採橫排稱為縱中橫排。

若要達到縱中橫排的話,請將對象文字以半型「^」符號包覆。橫排時,這項指定沒有任何效果。

書寫方式

民國^74^年

変換されたHTML

<p>民國<span class="tcy">74</span>年</p>

此外,CSS中也必須要有以下描述。(電電轉換器的預設樣式表中已經具備。)

.tcy { -epub-text-combine: horizontal;}

注意

縱中橫排所指定的文字數最好為2個半型字。

若指定超過這數量的文字列為縱中橫排時,就可能會解除縱中橫排,或者文字從該行切出,與其他行文字重疊。

注釋

  • PHP Markdown Extra
  • 電電 Markdown

注釋的記法與間接連結十分相似。於要加入注釋之處插入方括弧「[]」,於其中寫入「^」符號後接任意的文字。這就是注釋的連結ID。

對應的注釋定義,於連結ID後加上半型冒號「:」與半型空白後,書寫注釋內容。

書寫方式

這是有注釋[^1]的段落。

[^1]: 然後這裡是注釋內容。

注釋中若含有多數段落時,與列表中有著段落的處理方式相同,於行首加入4個半型空白。

書寫方式

這是有注釋[^1]的段落。

[^1]: 然後這裡是注釋內容中的段落。

    這裡是同樣注釋內容中另一個段落。

也可以這麼寫。

這是有注釋[^1]的段落。

[^1]: 
    然後這裡是注釋內容中的段落。

    這裡是同樣注釋內容中另一個段落。

電電 Markdown 會將注釋以合乎 XHTML 規範與 EPUB 注釋標準的型態輸出 HTML 碼。

電電 Markdown

<p>這是有注釋<a id="fnref_1" href="#fn_1" rel="footnote" class="noteref" epub:type="noteref" role="noteref">1</a>的段落。</p>

<div class="footnotes" epub:type="footnotes" role="doc-endnotes">
<hr />
<ol>

<li>
<div id="fn_1" class="footnote" epub:type="footnote" role="doc-endnote">
<p>然後這裡是注釋內容中的段落。</p>

<p>這裡是同樣注釋內容中另一個段落。<a href="#fnref_1" role="doc-backlink">&#9166;</a></p>
</div>
</li>

</ol>
</div>

此外,PHP Markdown Extra 的預設狀態會輸出如以下的代碼。

PHP Markdown Extra

<p>這是有注釋<sup id="fnref:1"><a href="#fn:1" rel="footnote">1</a></sup>的段落。</p>

<div class="footnotes">
<hr />
<ol>

<li id="fn:1">
<p>然後這裡是注釋內容中的段落。</p>

<p>這裡是同樣注釋內容中另一個段落。 <a href="#fnref:1" rev="footnote">&#8617;</a></p>
</li>

</ol>
</div>

警告

注釋定義雖然能夠將連結定義寫於文件中的任何位置,但是卻不能超出換頁(檔案分割)的範圍之外。不然的話,注釋標記無法找到對應的注釋定義,造成連結失效。

轉換後的注釋顯示位置,無關注釋定義所記載的位置,一律位於文件的最末

注釋標記請與注釋定義以1對1的方式相互對應。單一注釋定義無法對應多處的注釋標記。

注釋的連結ID雖然可以指定為任何文字,但轉換後會自動從「1」作為開始,重新依序分配編號。

圖片

  • Markdown
  • PHP Markdown Extra
  • 電電 Markdown

圖片與超連結的結構相當近似,有著直接連接與間接連結兩種方式。

直接連結

指定直接連結時,先以半型驚嘆號「!」作為開頭,接續著方括弧「[]」。於方括弧中,輸入取代圖片顯示的文字。其後接續半型括弧「()」,請於半型括弧中輸入圖片的路徑。

提示

由於電電轉換器並不能上傳資料夾,所以圖片檔案會與文字檔案配至於相同層級。由於如此,圖片路徑部分,直接輸入圖片檔名就好。

書寫方式

![代替文字](img.jpg)

轉換後的HTML

<img src="img.jpg" alt="代替文字" />

若圖片為沒有意涵的裝飾用圖片,代替文字也可以省略。

![](img.jpg)

轉換後的HTML

<img src="img.jpg" alt="" />

間接連結

間接連結則是以方括弧「[]」所包覆的連結ID取代圖片路徑。與連結定義為超連結時相同,能夠寫於任意的位置。連結定義則於圖片路徑後加上半型空白後記述,其後可以引述符號「""」記述代替文字。

書寫方式

![代替文字][id]

[id]: img.jpg
 

提示

Markdown記法,無法指定圖片大小。

若需指定圖片大小,有必要直接寫入 <img> 標籤中,或者客製CSS樣式表。

注意

透過電電轉換器轉換為EPUB時,請不要忘了將使用的圖片檔案與文字檔案一併上傳。

警告

間接連結雖然能夠將連結定義寫於文件中的任何位置,但是卻不能超出換頁(檔案分割)的範圍之外。不然的話,標記無法找到對應的連結定義,造成連結失效。

定義清單

  • PHP Markdown Extra
  • 電電 Markdown

定義清單是由項目,以及對其之說明所構成的清單。

定義清單首先於最初的一行寫出其項目。第二行則由半型冒號「:」起,後接1~3個半型空白,並於之後書寫對該項目的說明。

當有著複數項目時,請於前一項目的說明與次一項目之間加入空行分隔。

書寫方式

電電 Markdown 
:   基於 Markdown 的簡易標記語言

電電轉換器
:   將電電 Markdown 轉換成 EPUB 的 Web Service

轉換後的HTML

<dl>
<dt>電電 Markdown</dt>
<dd>基於 Markdown 的簡易標記語言</dd>

<dt>電電轉換器</dt>
<dd>將電電 Markdown 轉換成 EPUB 的 Web Service</dd>
</dl>

也能針對單一項目,加上複數說明。

書寫方式

電電 Markdown 
:   「為電書妹而生、供電書妹使用的 Markdown 延伸記法及其實裝」的略稱
:   基於 Markdown 的簡易標記語言

電電轉換器
:   「對應為電書妹而生、供電書妹使用的Markdown延伸記法之EPUB轉換器」的略稱
:   將電電 Markdown 轉換成 EPUB 的 Web Service

轉換後的HTML

<dl>
<dt>電電 Markdown</dt>
<dd>「為電書妹而生、供電書妹使用的Markdown延伸記法及其實裝」的略稱</dd>
<dd>基於Markdown的簡易標記語言</dd>

<dt>電電轉換器</dt>
<dd>「對應為電書妹而生、供電書妹使用的Markdown延伸記法之EPUB轉換器」的略稱</dd>
<dd>將電電 Markdown 轉換成 EPUB 的 Web Service</dd>
</dl>

若於項目與說明間加入空行的話,說明就會變成段落。

書寫方式

電電 Markdown

:   基於 Markdown 的簡易標記語言

電電轉換器

:   將電電 Markdown 轉換成 EPUB 的 Web Service

轉換後的HTML

<dl>
<dt>電電 Markdown</dt>
<dd>
<p>基於 Markdown 的簡易標記語言</p>
</dd>

<dt>電電轉換器</dt>
<dd>
<p>將電電 Markdown 轉換成 EPUB 的 Web Service</p>
</dd>
</dl>

說明中若有著複數的段落,或者引用列表的話,請於行首加入4個半型空白。

若有著程式碼的話,請於行首加入8個半型空白。

書寫方式

項目

:   這是說明該項目的段落。

    這是說明該項目的其他段落。

項目

:   下面是程式碼。

        <body>
          <p>Hello world.</p>
        </body>

    > 這是項目說明中的引用文。

    1. 蘋果
    2. 桃子
    3. 橘子

轉換後的HTML

<dl>
<dt>項目</dt>
<dd>
<p>這是說明該項目的段落。</p>

<p>這是說明該項目的其他段落。</p>
</dd>

<dt>項目</dt>
<dd>
<p>下面是程式碼。</p>

<pre><code>&lt;body&gt;
  &lt;p&gt;Hello world.&lt;/p&gt;
&lt;/body&gt;
</code></pre>

<blockquote>
  <p>這是項目說明中的引用文。</p>
</blockquote>

<ol>
<li>蘋果</li>
<li>桃子</li>
<li>橘子</li>
</ol>
</dd>
</dl>

表格

  • PHP Markdown Extra
  • 電電 Markdown

透過半型垂直線「|」與減號「-」的組合,就能如下面一般製作出簡單的表格。

書寫方式

名稱    | 人口
------- | ----------
台北市   | 262萬人
北京市   | 2018萬人

轉換後的HTML

<table>
<thead>
<tr>
  <th>名稱</th>
  <th>人口</th>
</tr>
</thead>
<tbody>
<tr>
  <td>台北市</td>
  <td>262萬人</td>
</tr>
<tr>
  <td>北京市</td>
  <td>2018萬人</td>
</tr>
</tbody>
</table>

HTML

於 Markdown 中也能夠直接寫進HTML標籤。到此為止所學到的記法不能對應的呈現方式,可以透過寫進 HTML 標籤的方法使其實現。

文中的 HTML 記述

  • Markdown
  • PHP Markdown Extra
  • 電電 Markdown

於文章行內所書寫的HTML標籤都可以使用,可用標籤有著例、<span><b><cite><i><img><u><q><small><del><ins> 等等。

書寫方式

這是在段落之中直接將書籍的<cite>書名</cite>以 HTML 標記的範例。

轉換後的HTML

<p>這是在段落之中直接將書籍的<cite>書名</cite>以 HTML 標記的範例。。</p>

但也有著需注意的地方。構成區塊標籤內部的Markdown記法將不會轉換。這樣的標籤例如:<div><<p><table><pre> 等等。

書寫方式

這是**一般的**段落。

<div>
**區塊中的段落**裡的 Markdown 不會被轉換。
</div>

轉換後的HTML

<p>這是<strong>一般的</strong>段落。</p>

<div>
**區塊中的段落**裡的 Markdown 不會被轉換。
</div>

HTML 標籤區塊中 Markdown 的記述

  • PHP Markdown Extra
  • 電電 Markdown

前述構成區塊標籤之中,若希望讓 Markdown(或者 PHP Markdown Extra、電電 Markdown)也能被轉換的話,請於標籤內加上 markdown="1"的屬性。這屬性會在轉換後的HTML中刪除。

書寫方式

這是**一般的**段落。

<div markdown="1">
**區塊中的段落**裡的Markdown也能被轉換。
</div>

轉換後的HTML

<p>這是<strong>一般的</strong>段落。</p>

<div>
<p><strong>區塊中的段落</strong>裡的Markdown也能被轉換。</p>
</div>