使用手冊：編輯器操作指南

這是什麼

Wypxital 是一個「文本 → PDF」的瀏覽器端編輯器：左側是富文本編輯區（Lexical），使用者打字排版；按下「預覽 PDF」後，排版會在瀏覽器內即時編譯成 PDF（Typst 引擎），全程不經過任何後端伺服器——你的文件內容不會被上傳到任何地方。

目前是 PoC（概念驗證）階段：功能以「驗證瀏覽器端排版可行性」為主，還沒有帳號系統、雲端儲存或版本歷史，見下方已知限制。

開始使用

從導覽列點「編輯器工具」，或直接前往 /editor。頁面分成三塊：

頂部列：左邊是可點選編輯的檔案名稱（點一下就能改，不含副檔名），右邊是「載入測試內容」與「預覽 PDF」兩個按鈕。
左側工具箱：格式化工具、版面設定、頁首頁尾設定，三區固定展開，不需要另外點開。
右側編輯區：實際打字排版的地方，可獨立捲動。

不知道從哪裡開始最快？點右上角的「載入測試內容」——會塞入一份涵蓋標題、清單、表格、字級、程式碼區塊等所有功能的長文，直接照著改比從空白頁開始快很多。

編輯內容

基礎格式

工具箱最上面是格式化控制項，垂直分區排列（編輯／段落與文字／清單與插入）：

文字格式：粗體、底線、刪除線、行內程式碼（4 個切換按鈕）
段落類型：一般段落、H1–H6 標題、引言、程式碼區塊、清單（下拉選單切換）
字級：4 種尺寸（xs／sm／lg／xl），對選取範圍套用

也支援打 Markdown 語法即打即轉：**粗體**、# 標題 這類寫法會在你打完後立刻變成對應的格式，不用滑鼠點工具列。

程式碼區塊

段落類型選「程式碼區塊」後，工具箱會多顯示一個語言下拉選單（16 種內建語言：C、C++、CSS、HTML、Java、JavaScript、Markdown、Objective-C、Plain、PowerShell、Python、Rust、SQL、Swift、TypeScript、XML），選好後該區塊會依語法自動上色。區塊內支援 Tab／Shift+Tab 縮排。

表格

插入表格後，選取儲存格可設定底色：純色色票，或切到「漸層」模式自訂起點色／終點色／方向（左到右、右到左、上到下、下到上），調整任一欄位即時套用。

圖片

插入的圖片直接內嵌存在文件裡（不是另外上傳到某個網址），寬度只有「小／中／滿版」3 個固定尺寸可選，不支援自由拖曳縮放。

插入符號與交叉引用

工具箱有「插入符號」按鈕，跳出一個依類別（箭頭／數學／標點／花色與圖形）分組的符號挑選面板；「插入交叉引用」則可以挑一個你已經下過標籤的標題、圖片或表格，插入一個會自動對應編號的引用（例如「詳見表 3」，表格編號若之後調整，引用會自動更新，不用手動改）。

手動分頁

想強制在某處換頁，用「插入分頁」——會在該位置放一個換頁標記，匯出 PDF 時該處會另起一頁。編輯畫面本身不會顯示分頁效果（見下方限制），只有匯出的 PDF 才看得到實際分頁結果。

儲存快捷鍵

Ctrl+S（Mac Cmd+S）目前只是攔截瀏覽器預設的「儲存網頁」行為，本身不會把內容存到任何地方——這個 PoC 階段還沒有持久化機制，離開分頁或重新整理內容就會消失，請自行複製重要內容到別處備份。

版面設定

工具箱中段是版面設定，比照 Word 的邏輯，這些欄位只決定「排版規則」，不是格式化你目前選取的文字：

紙張尺寸
頁面邊界（毫米）
行距、段落間距、字距（皆為 em 單位）
左右齊行 開關

調整後編輯區的視覺會盡量近似最終結果，但行距等少數欄位是近似換算，實際以匯出的 PDF 為準。

頁首頁尾

工具箱最下段可設定頁首／頁尾，各自最多 4 欄，每欄可自訂文字與對齊方式。文字輸入框內可在游標位置「插入」動態欄位：

{{page}} — 目前頁碼
{{totalPages}} — 總頁數
{{date}} — 日期

這些是純文字佔位符，實際數值由匯出時的 PDF 引擎即時算出並替換。

預覽與匯出 PDF

按頂部列「預覽 PDF」開啟預覽視窗，畫面會即時編譯排版並顯示結果；視窗開著時調整下列設定會自動重新編譯，不用重新點按鈕：

文件屬性：作者、關鍵字（寫入 PDF 中繼資料）、「文件開頭插入目錄」開關、文件日期（預設帶入當下系統時間，可自行調整或按「重設」）
頁面底色／浮水印：整頁底色、浮水印文字與不透明度

這兩組設定因為在編輯畫布上完全看不到效果，才刻意放在預覽視窗（能立即看到結果的地方），不是工具箱的疏漏。

已知限制

常見問題

Q：我可以用手機編輯嗎？ 可以開啟，但排版工具偏多、操作面積偏小，建議用桌面瀏覽器 + 較寬的螢幕操作體驗較好。

Q：字型看起來跟預覽 PDF 不完全一樣？ 編輯區的字型與間距是近似顯示，實際排版結果一律以「預覽 PDF」跳出的成品為準。

Q：可以匯入既有的 Word／PDF 文件嗎？ 目前不行，Wypxital 是從空白內容或「載入測試內容」開始編輯，沒有既有文件匯入功能。