本頁面提供 PmWiki 寫作語法的完整清單。

其實不使用下列的寫作語法也可以輕鬆地建立和編輯網頁，但是一旦你需要格式化你的文字內容，請仔細閱讀底下的說明。

如果要練習這些寫作語法，請到 測試沙箱。

文字段落

• 每行文字的開頭，一般來說不能有任何空格（「空格」放在每行的開頭，代表某種特殊的格式標記，底下會有說明。）。
• 請勿用空格或定位符號（按下 Tab）來縮排文字段落，如需縮排，下一節有詳細說明。
• 可以任意換行和填充文字。
• 使用空白行來作為段落分隔。
• 在每行的開頭縮進一個或更多的空格（或按下 Tab），表示保持原來的文字排版（即 HTML 標記裡頭的 <pre></pre>）。
• 在每行的末尾使用 \（反斜線），將把下一行接在一起，而不是斷行。
• 在每行的末尾使用 \\（雙反斜線），將強迫斷行。

段落縮排（常用在引用別人的文章內容）

在段落的開頭使用箭頭 ->，可以產生段落縮排，連字符號 ---> 越多，縮得越深。

使用範例：

 ->Four score and seven years ago our fathers placed upon this
 continent a new nation, conceived in liberty and dedicated to the
 proposition that all men are created equal.

顯示結果：

強調文字語氣

• 斜體：用兩個單引號 '' 加在文字前後，例如，''two apostrophies''。
• 粗體：用三個單引號 ''' 加在文字前後，例如，'''three apostrophes'''。
• 粗斜體：用五個單引號 ''''' 加在文字前後，或是雙引號加上三個單引號，例如，"'''five apostrophes'''"。
• 使用兩個 at 字元 @@ 加在文字前後，例如 @@monospace@@，表示使用等寬字型（monospace）。
• 夾在 [+ 和 +] 之間的文字，表示 文字放大 ，夾在 [+ 和 +] 之間的文字，表示 文字縮小
• 文字語氣的強調，在一行中可任意使用多次，但是文字中間不得斷行。

要使用更複雜的格式化文字，請參考 文字格式 的說明。

標題

在每行的開頭使用驚嘆號 !，表示本行是標題，感歎號越多，標題層次越減。

使用範例：

 ! Level 1 Heading
 !! Level 2 Heading
 !!! Level 3 Heading
 !!!! Level 4 Heading
 !!!!! Level 5 Heading
 !!!!!! Level 6 Heading

顯示結果：

Level 1 Heading

Level 2 Heading

Level 3 Heading

Level 4 Heading

Level 5 Heading

Level 6 Heading

項目列表

在每行的開頭使用星號 *，表示本行是項目列表，星號越多，層次越深。

使用範例：

 * First-level list item
 ** Second-level list item
 ** Another second-level item
 * A first-level item

顯示結果：

• First-level list item
  • Second-level list item
  • Another second-level item
• A first-level item

編號列表

在每行的開頭使用井字號 #，表示本行是編號列表，井字號越多，層次越深。

使用範例：

 # Prepare the experiment
 ## Unwrap the pop-tart
 ## Insert the pop-tart into the toaster
 # Begin cooking the pop tart
 # Stand back

顯示結果：

1. Prepare the experiment
   1. Unwrap the pop-tart
   2. Insert the pop-tart into the toaster
2. Begin cooking the pop tart
3. Stand back

定義列表

在每行的開頭使用冒號 :，表示本行是定義列表，冒號越多，層次越深。

使用範例：

 :term:definition of term
 ::second-level item: definition of 2nd-level item

顯示結果：

term

definition of term

second-level item

definition of 2nd-level item

水平線

在每行的開頭使用至少四個或更多的連字符號 ----，可以產生水平線。

網頁連結

• 使用 WikiWords -- 由兩個以上、單字間不含空白、且字首皆為大寫的英文單字，連在一起組合而成 -- 將會自動建立連結。
• 網址 URLs 前用 "http:", "ftp:", "gopher:", "mailto:", 或 "news:" 開頭，將會自動建立連結，例如 http://www.pmichaud.com/toast 。
• 網址 URLs 末尾是 .gif, .jpg, 或 .png 將會直接顯示圖片。
  • 在每行的開頭使用圖片網址 URLs，文字將會自動由右邊繞圖排列。
  • 在每行的末尾使用圖片網址 URLs，文字將會自動由左邊繞圖排列。
  • 圖片網址 URLs 如果單獨一行，將不會有文字繞圖的效果。
• 網址 URLs 本身可以放在雙中括號中間 [[url]]，這時網址 URLs 不會顯示出來，會用阿拉伯數字編號來代替。例如，[[http://www.google.com/]] 將會顯示為阿拉伯數字 [1]。
• 雙中括號中的網址 URLs 還可以加上文字說明 [[url text]] 或 [[WikiWord text]]。text 也可是圖片網址 URLs，點一下圖形就會連到 url 或 WikiWord。
• 網頁內的參考連結 #，可以使用 [[#target]] 來建立。

自由連結

free link 是不遵循 WikiWord 命名規則的網頁連結。

如果在文章中使用 WikiWord ，且顯示的連結文字看起來很突兀的話，這時候使用雙大括號，例如 {{free links}} 來建立連結，會很有用。

{{text}} 會連結到名稱為 Text 的網頁，{{basic editing}} 則會替實際名稱為 BasicEditing 的網頁建立連結，但是這時會顯示成 basic editing 的連結文字，在閱讀文章上，這樣比 WikiWord 看起來顯得較為自然美觀。

雙大括號 }} 後面還可以加上任意文字，所以 {{wiki word}}s 顯示為 wiki words 的網頁連結。

請參考 自由連結 裡頭更詳盡的說明。

不做格式化（常用於顯示程式代碼）

放在 [= 和 =] 當中的任何文字不會被 PmWiki 格式化。例如，[=WikiWords=] 將不會自動建立連結，而是顯示成一般的文字 WikiWords。

[= 和 =] 之間可以跨行，這會讓整個段落不被格式化。

例如，每行開頭的 [= 會讓到下一個 =] 中的文字顯示為等寬字型（monospace）的純文字。

表格

在每行的開頭使用 '||'，表示這是表格，'||' 後面可以設定整個表格的 HTML 顯示屬性。

表格欄位也是使用 '||' 來隔開，每個欄位前後都留有空格，表示文字置中；只有前面留有空格，表示文字向右對齊；沒有特別設定，則一律是向左對齊。

完全空白的欄位將會自動合併前一個欄位（目前還沒有辦法合併多行）。

使用範例：

        ||align=center border=1 width=50%
        ||Left   || Center ||  Right||
        ||A      ||    B   ||      C||
        ||       || single || ||
        ||       || multi span ||||

顯示結果：

Left	Center	Right
A	B	C
	single
	multi span

請參考 SimpleTables ，SimpleTables2 和 AdvancedTables （英文）裡頭更詳盡的說明。

特別符號

請參考 SpecialCharacters 的說明（英文）。

註釋文字

用 %comment% 加在文字之前，表示這是註釋文字。

加上 %comment% 註釋後，直到行尾或下一個 %% 中的整段文字將不會在網頁上顯示出來。

使用範例：

 %comment% This is a hidden comment line that doesn't show.