Markdown代碼示例怎麼寫：代碼圍欄、縮進與高亮邊界

開始前先確認

遇到後面的段落一起變成代碼，先查結束圍欄；代碼塊存在卻沒有顏色，先查高亮支持；顯示正常但複製後不能使用，則繼續覈對縮進、字符和示例本身。這三類問題不該靠同一種修改解決。

多行示例先用完整圍欄

在代碼前後各放一行反引號圍欄，前後與正文留空行，便於檢查。下面外層用四個反引號展示完整寫法，複製框內內容時，會得到一個三反引號的Python代碼塊。

```python
items = ["原稿", "编辑稿", "分享稿"]
for item in items:
    print(item)
```

開頭的python是語言提示，結束行只寫圍欄，不再補一次語言名。預期是列表賦值、循環和帶縮進的打印語句顯示在同一個代碼塊中。這個例子沒有執行記錄，不能把排版預覽當成運行結果。

檢查圍欄時注意使用英文反引號，不是單引號、中文引號或形狀相近的符號。教程複製過程中若標點被自動替換，肉眼看起來相似也可能不是同一字符。

想展示圍欄本身，就把外層加長

寫Markdown教程時，代碼內容本身可能含有三反引號。若外層也用同樣長度，裏面的結束行可能提前結束外層展示。按GitHub代碼塊文檔介紹的方法，可用四反引號包住包含三反引號的內容。

下面是另一個可複製例子：

```text
# 这是一行示例文本
- 这里不是正文列表
```

在這個示例中，井號和短橫線都屬於被展示的文本，不應生成文章標題或列表。把它複製到目標Markdown環境後，檢查兩行示例文本是否完整，而不是隻看有沒有灰色背景。

如果需要展示的內容還包含四反引號，應再次選用更長的外層圍欄，避免內部出現能關閉外層的標記。原則是先清楚區分“文章用於包裹示例的圍欄”和“示例自己的一部分”，不能靠多加幾個空行補救錯誤閉合。

縮進既影響排版，也可能屬於代碼

Python等語言依賴縮進表示結構；其他語言的縮進也會影響可讀性。先保留真實代碼需要的前導空格，再處理Markdown本身的容器縮進。不要爲了讓源碼左邊整齊，把循環或條件內部的空格全部刪掉。

Markdown也有縮進式代碼塊，但在列表、引用和普通段落之間，它與容器層級容易混淆。新手寫獨立代碼示例時，顯式圍欄更便於看出起止位置。若代碼塊要放在列表項內，應按所在列表的結構調整縮進，並檢查它是否仍屬於該條目。

排查時可以先把代碼塊移到普通段落之間，確認獨立顯示正確，再放回列表。這是縮小問題範圍的方法，不代表最終必須刪除列表結構。

語言標記管高亮，不管執行

標記爲python、html或其他語言，通常只是給渲染器一個識別提示。沒有安裝相應高亮能力、語言名不被識別或導出樣式未保留，都可能導致代碼沒有顏色，但文本仍然完整。

若內容只是文件清單、日誌或輸出片段，可使用目標環境支持的純文本標記，或不寫語言提示。不要爲了獲得顏色，把日誌錯誤標成某種程序語言，再讓讀者誤以爲它可直接執行。

高亮顏色也不是語法驗證。引號缺失、變量未定義或命令參數有誤，仍可能被漂亮地着色。文檔若要聲稱“已運行”，應另有對應環境與執行證據；僅通過Markdown預覽不能作此聲明。

短名稱用行內代碼，完整命令用塊

文件名、變量名或短函數名可以放在一對反引號中，例如output.html。完整命令、多行配置和需要保留層級的內容則放進代碼塊，避免依賴行內代碼維持換行。

給可複製示例時，不要把解釋句、終端提示符或輸出內容混進實際輸入，除非明確說明哪些應複製。若爲了講解使用佔位值，應標明它需要替換；不能讓讀者把省略號當成完整可用的代碼。

遇到很長的一行，查看器視覺換行和源碼真正插入換行是兩回事。複製後應覈對實際行結構，尤其是字符串、路徑或命令參數，不要僅憑頁面上折成了兩行就手工補回車。

從原稿到導出，檢查同一段內容

先保存Markdown原稿，再看預覽裏圍欄是否正確閉合、縮進是否保留、代碼後的正文是否恢復正常。導出HTML後重新打開，抽取同一段複製回純文本編輯器，覈對引號、空格和行數。

長行在窄窗口裏可能需要橫向滾動，這屬於展示問題，不應隨意改寫代碼來消除滾動條。若內容本身可以合理拆行，應按對應語言語法修改，而不是爲了排版硬斷開標識符。

完整文件交付檢查可參考Markdown導出指南。本站導出會進行內容清理，不應把代碼展示理解爲網頁腳本執行環境；某個HTML片段能作爲文字顯示，也不表示它會被運行。

需要邊寫邊看排版時，可打開AI Lab Markdown編輯器。公開說明支持實時預覽、Markdown與經過清理的HTML導出，9積分解鎖後當前賬號長期有效。本文沒有核驗具體高亮語言、行號或代碼運行按鈕，不能把GitHub文檔中的全部能力歸給本站。