本頁面提供
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.
顯示結果：
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
顯示結果：
- Prepare the experiment
- Unwrap the pop-tart
- Insert the pop-tart into the toaster
- Begin cooking the pop tart
- 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] [http://www.google.com/]。
- 雙中括號中的網址 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.