imported>SuperGrey：/* 範例 */

2026-01-08T12:06:55Z

範例

新页面

{{Documentation subpage}}

==說明==
{{tlx|Markup}}可以將代碼和其效果顯示在同一行裡。

==使用方法==
參數：
* '''參數1'''：第1行第1格的內容
* '''參數2'''：第1行第2格的內容
:如此類推，直到
* '''參數39'''：第20行第1格的內容
* '''參數40'''：第20行第2格的內容
* '''t1'''：左面直欄的標題，預設為“''代碼''”
* '''t2'''：右面直欄的標題，預設為“''效果''”
* '''title'''、'''標題'''：表格標題，預設為置空
* '''notitle'''、'''無標題'''：賦值時會隱藏表格和直欄的標題
* '''tag'''：預設為<code>pre</code>；可填入<code>syntaxhighlight</code>，但僅對單行程式碼可用
* '''margin'''：表格左邊的空位大小，單位為em

整個“''代碼''”欄已事先用{{tag|pre|o}}格式化，內容會保留斷行和空格，同時亦會因應單元格的大小自動換行。通常最好用{{xtag|nowiki}}包圍著“''代碼''”欄裡的內容，這樣子便會顯示代碼本身。技術上無法將此功能添加進本模板內。

相反地，在“''效果''”一欄裡的內容通常直接複製自“''代碼''”欄，但並不以{{tag|nowiki|o}}包圍著。不過在這些情況下則不一定：

* 假如第一行含有必須斷行後才生效的維基代碼，例如“#”、“*”、“;”，應在第一行之前使用{{tl|crlf2}}。見以下例子。
* 諸如{{code|1===}}的標題代碼會出現在頁面目錄裡；要避免的話應使用{{tlx|fake heading}}。
* 使用{{tlx|reflist}}但沒有指定其他參數時，用{{tlx|reflist|close}}確保參考資料列表已關閉。
* 有些模板會將頁面放入維護分類中，但這通常不是想要的效果：
** 用{{tlx|fake citation needed}}代替{{tlx|citation needed}}。
* 有些模板可能有檢查錯誤機制，會將頁面放入維護分類中。可以的話應當防止分類：
** {{cs1}}系列模板可以用{{para|template doc demo|true}}參數，防止將頁面放入該維護分類中。

==技術限制==
如果不用{{xtag|nowiki}}包圍著代碼欄的內容，而裡面又有任何模板代碼的話，這些代碼統統都會展開。

以下例子展示<nowiki>{{tl|tag}}</nowiki>的代碼：

{{markup|t1=效果|t2=本來應顯示為
|{{tl|tag}}
|<nowiki>{{tl|tag}}</nowiki>
}}

代碼欄裡的HTML字符編碼也會被解析：
{{markup|t1=用“nowiki”包圍著的代碼顯示為|t2=代碼本來應顯示為
|<nowiki> –</nowiki>
|&nbsp;&ndash;
}}

要避免出現這種情況的話，可以手動將“<code>&amp;</code>”代替“<code>&</code>”，這樣子“<code>&amp;nbsp;</code>”會顯示為“<code>&nbsp;</code>”。

==範例==

'''簡單示例：'''
{{markup
|<nowiki>'''粗體文字'''</nowiki>|'''粗體文字'''
|<nowiki>''斜體文字''</nowiki>|''斜體文字''
|<nowiki><del>劃線文字</del></nowiki>|<del>劃線文字</del>
}}

'''複雜示例：'''注意{{tl2|markup}}的第二個參數用了{{tl2|fake heading}}和{{tl2|fake citation needed}}。
{{markup|tag=syntaxhighlight
|<nowiki>The quick brown fox jumps over the lazy dog.{{#tag:ref|這是腳註。</nowiki><<nowiki>ref</nowiki>><nowiki>這是腳註的參考資料。</nowiki><<nowiki>/ref</nowiki>><nowiki>|group=nb}} The cow jumped over the moon.{{fact}}

==註釋==
{{reflist|group=nb}}

==參考資料==
{{reflist}}
</nowiki>
|The quick brown fox jumps over the lazy dog.{{#tag:ref|這是腳註。<ref>這是腳註的參考資料。</ref>|group=nb}} The cow jumped over the moon.{{fake fact}}

{{fake heading|sub=2|註釋}}
{{reflist|group=nb}}

{{fake heading|sub=2|參考資料}}
{{reflist|close}}
}}

'''使用多行：'''
{{markup
|The quick brown fox jumps over the lazy dog.
|The quick brown fox jumps over the lazy dog.
|The quick brown fox jumps over the lazy dog.
|The quick brown fox jumps over the lazy dog.
|The quick brown fox jumps over the lazy dog.
|The quick brown fox jumps over the lazy dog.
|The quick brown fox jumps over the lazy dog.
|The quick brown fox jumps over the lazy dog.
|The quick brown fox jumps over the lazy dog.
|The quick brown fox jumps over the lazy dog.
}}

'''使用標題：'''
{{markup|title=Foxes and dogs
|The quick brown fox jumps over the lazy dog.
|The quick brown fox jumps over the lazy dog.
}}

用{{tl|code}}包圍著模板時，會顯示所生成的HTML代碼：
{{markup|tag=syntaxhighlight
|<nowiki>{{cite book |last=White |first=T. H. |title=The Book of Merlyn |year=1977}}</nowiki>
|{{cite book |last=White |first=T. H. |title=The Book of Merlyn |year=1977}}
|<nowiki>{{code|{{cite book |last=White |first=T. H. |title=The Book of Merlyn |year=1977}}}}</nowiki>
|{{code|{{cite book |last=White |first=T. H. |title=The Book of Merlyn |year=1977}}}}
}}

==參見==
{{Markup templates see also}}
<includeonly>

[[Category:精密模板]]{{#ifeq:{{SUBPAGENAME}}|sandbox||
[[Category:模板測試樣例]]
[[Category:模板頁的模板]]
[[Category:文件支援模板]]
}}</includeonly>

Template:Markup/doc - 版本历史

imported>SuperGrey：​/* 範例 */

imported>SuperGrey：/* 範例 */