轉換器會辨識 underline / overline RST heading、inline RST link、由 double colon 語法開啟的 literal block,以及右括號形式的編號列表。這些 pattern 會被改寫成 Markdown heading、link、fenced code block 與編號列表。
reStructuredText 有許多 directive 與 table 寫法會依專案而異。這個轉換器會讓未支援的行維持可讀,而不是猜測所有 Sphinx extension;directive、table、substitution 與 custom role 仍應人工檢查。
關於這個主題的常見疑問與實用解答。
reStructuredText(rst)是一種輕量級標記語言,常用於 Python 文件與 Sphinx 專案中。
轉換器會改寫 underline / overline heading、inline link、literal block,以及 `1)` 形式的編號列表。表格、directive、substitution 與 custom role 會以文字保留,需人工檢查。
常見情境包括將 Sphinx 文件遷移到 MkDocs、GitHub Wiki 或其他基於 Markdown 的文件平台。
不會,reStructuredText 轉 Markdown 的轉換完全在您的瀏覽器中執行。您的文件透過 JavaScript 在本地轉換,不會被上傳。