使用方式
- 在第一列輸入標題,並在其下方輸入資料;或開啟「從 CSV 填入…」並貼上試算表的儲存格。
- 使用按鈕新增或移除列與欄。
- 使用各欄上方的選單設定對齊方式。
- 選擇 Markdown 或 HTML,然後複製或下載表格。
運作方式
Markdown 輸出遵循 GitHub Flavored Markdown (GFM) 的表格語法,GitHub、GitLab、許多文件產生器以及大多數 Markdown 編輯器都支援此語法。第一列會成為標題列,接著是設定對齊方式的分隔列::--- 表示靠左、:---: 表示置中、---: 表示靠右,而 --- 表示預設。
儲存格內容會經過跳脫,避免破壞表格:儲存格內的 | 會寫成 \|,換行會變成 <br>,因為 GFM 表格列必須保持在同一行。儲存格內的其他 Markdown(例如 **bold** 或 `code`)會保留,並由 Markdown 檢視器呈現。使用「以空格對齊欄位」時,每個欄位都會補齊至相同寬度,讓表格以純文字閱讀;中文、日文或韓文等字元會以兩個欄位寬度計算。儲存格較少的列會以空白儲存格補齊。
匯入功能接受 Tab 分隔文字(試算表複製到剪貼簿的內容)、以逗號或分號分隔的 CSV(包括以引號括起且內含逗號、引號和換行的欄位),以及現有的 Markdown 表格;其對齊列也會一併讀取。
HTML 輸出為單純的 <table>,包含 <thead> 和 <tbody>。文字會進行 HTML 跳脫(& < > "),換行會變成 <br>,對齊方式則以內嵌 text-align 樣式設定,因此不需樣式表即可正常顯示。
範例
試算表轉 README
在 Google Sheets 中選取一個範圍,複製後貼到匯入方塊,然後按一下「填入表格」。將價格欄設為靠右對齊,並將 Markdown 複製到 README.md。
含有豎線字元的文字
含有「Unlimited | fair use」的儲存格要寫成 Unlimited \| fair use,這樣 GitHub 會顯示豎線字元,而不是另起新欄位。
整理現有表格
貼上間距不整齊的手寫 Markdown 表格,按一下「填入表格」,再把結果複製回去,所有欄位都會對齊並保留對齊方式。
常見問題
儲存格可以包含換行嗎?
不算是真正的換行,因為在 Markdown 中每一列表格都必須是一行。產生器會改寫成 <br>,GitHub 和多數檢視器都會顯示為換行。
為什麼一定要有標題列?
GFM 表格一律以標題列開頭,其後接著對齊列。若不想要顯示標題,可以將標題儲存格留空,但多數檢視器仍會畫出標題分隔線。
可以合併儲存格嗎?
不行。Markdown 表格不支援合併儲存格(colspan 或 rowspan)。如果需要,請改用 HTML 輸出並手動加入 colspan 或 rowspan 屬性。
內縮會改變表格渲染後的外觀嗎?
不會。Markdown 在渲染時會忽略多餘空格。內縮只是讓原始碼更容易閱讀和編輯。
隱私權
表格只會在您的瀏覽器中建立。您輸入或貼上的資料不會被上傳、儲存或用於分析。