跳轉到主要內容
在你的網站、部落格或課程頁面上放置一個連結。任何按下它的人都會得到一個包含你的檔案、屬於自己的新專案。無需任何設定。 訪客需要在你的執行個體上擁有帳號。未登入的訪客會先進入登入頁面,登入後專案才會開啟。 此功能的頁面使用 Overleaf 這個名稱。你自己的連結或按鈕可以使用任何文字,例如 Open in Ayakaleaf。

查看範例

在你的網站上開啟 /devs,例如 https://ayakaleaf.example.com/devs。沒有任何選單連結到此頁面,因此請自行輸入網址。預設情況下,你必須登入才能查看。
帶有 A LaTeX code snippet 和 A zipped project 按鈕的 Overleaf API 頁面

Overleaf API 頁面

按一下 A LaTeX code snippet 或 A zipped project。一個包含該範例的新專案會開啟。
專案 I am a Zip file,包含 main.tex、main2.tex 和 sample.bib 及其 PDF

來自壓縮檔範例的專案

1

建立連結

將檔案網址經過 URL 編碼後放在 /docs?snip_uri= 之後:
若是壓縮的專案,請使用 zip_uri:
你的執行個體會下載該檔案,因此它必須可以透過 HTTP 或 HTTPS 存取。私人網路上的網址會被拒絕,請參閱 External URL。
2

將它加入你的頁面

3

按下連結

新專案會在編輯器中開啟,其中只有一個儲存為 main.tex 的檔案。
編輯器中的專案 Hello from a link,包含 main.tex 及其 PDF

從連結開啟的專案

每按一次都會建立另一個專案。該專案是一份副本,因此之後對你的檔案所做的變更不會同步到它。
對於小型檔案,你無需託管任何內容:將其內容以 Base64 data URL 放入連結中。在 JavaScript 中:
btoa 只接受 Latin-1 字元,因此請先將其他文字編碼為 UTF-8。若是壓縮的專案,請使用 zip_uri 和 data:application/zip;base64,。 長度超過約 8 KB 的連結會被拒絕,並出現錯誤 414 Request-URI Too Large。若內容更大,請託管檔案或使用表單。

選擇選項

將下列參數加入連結,或以隱藏欄位加入表單: 沒有 \documentclass 的 .tex 檔案會被包裝在標準文件中,因此可以立即編譯:
表單傳送的參數與連結相同:
若要直接傳送 LaTeX 內容,純文字請使用 snip,經過 encodeURIComponent 處理的文字請使用 encoded_snip。 表單並非總是有效,因此除非你的檔案太長而無法放入連結,否則連結是較好的選擇: 如果管理員設定了 OVERLEAF_ALLOW_PUBLIC_ACCESS=true,在上述所有情況下專案都會開啟,必要時會先登入。該設定也會向未登入的訪客開放其他頁面,請參閱 Page Access。 關於管理員可以設定的其他項目,請參閱 Overleaf Import API。/devs 頁面上有更多範例。

如果專案沒有開啟

頁面會說明發生了什麼問題。View the Overleaf API docs 會帶你前往 /devs。
帶有訊息 invalid url 和 View the Overleaf API docs 按鈕的 Open in Overleaf 頁面

執行個體無法使用的連結

最後修改於 2026年11月20日