AdocMD Forge

使用 Asciidoctor.js 產生 AsciiDoc 預覽。

使用 markdown-it 產生 Markdown 預覽。

編輯文件後自動更新，不需要重新開啟預覽。

同一份來源文件只會開啟一個 Preview Panel。

支援來源編輯器與預覽畫面的雙向同步捲動。

自動套用 VS Code 深色、淺色與高對比佈景主題。

支援預覽中的本機圖片與相對連結。

在受信任工作區中支援安全範圍內的 AsciiDoc include::。

Open Preview 會依來源文件位置套用已儲存文件的 :stylesheet: 與 :stylesdir: 宣告的本機 .css；例如 :stylesheet: ../stylesheets/colony.css。未受信任工作區仍可套用位於工作區範圍內的 CSS，但 include、圖片與連結等其他本機資源仍受信任狀態限制。

Show Formatting Palette 使用 VS Code Quick Pick 顯示浮動格式面板，提供粗體、斜體、注目、等寬、刪除線、上標與下標，不在來源編輯器右上角常駐七個格式按鈕。

選取文字後可從右鍵選單開啟浮動格式面板或直接套用個別格式；有選取文字時包覆內容，沒有選取文字時插入成對標記並將游標放在中間。

Preview Webview 不顯示工具列；版面切換、重新整理、語法說明、HTML 與 PDF 匯出維持由來源編輯器標題列操作。

來源編輯器與 Outline 標題列操作使用 VS Code Codicon，滑鼠停留時以命令標題顯示功能說明，不占用右上角的文字寬度。

Preview 使用獨立外層內距，文件 stylesheet 即使設定 body { padding: 0 }，內容也不會貼齊面板邊緣。

可切換僅文字、文字／預覽分割與僅預覽版面。

AsciiDoc 與 Markdown 產出的 HTML 均會經過消毒。

Webview 使用 Content Security Policy 與具型別訊息。

未受信任工作區不讀取本機 include、本機圖片或本機連結。

遠端圖片預設停用，且只允許 HTTPS。

本機資源與連結不得逸出允許的工作區範圍。

只在 .adoc 與 .asciidoc 文件啟用語法補全與 Hover。

支援標題、段落、粗體、斜體、等寬文字、清單與 Checklist。

支援 Source Block、Admonition、表格、link、xref、anchor、image、include、attribute 與 TOC。

補全會依游標所在的語法前綴縮小範圍，不在一般段落文字中顯示無關項目。

提供繁體中文語法說明與可直接執行的範例。

在受信任的工作區中，將圖片拖曳至 AsciiDoc 或 Markdown 編輯器，擴充套件會詢問儲存位置並插入對應語法。

使用作業系統或其他應用程式複製圖片後，在 VS Code 編輯器執行貼上；若 VS Code 取得 image/* 或 files DataTransfer，會詢問儲存位置並插入對應語法。

Copy Image 指令會開啟圖片檔案選擇器，適用於剪貼簿無法提供二進位資料的環境。

AsciiDoc 會插入 image::relative/path.png[替代文字]，Markdown 會插入 ![替代文字](https://github.com/BucketHsu/adocmd-forge/raw/HEAD/relative/path.png)。

預設建議在目前文件旁建立 images/；同名檔案會產生 -2、-3 等新檔名，不會靜默覆蓋。

未儲存文件、未受信任工作區、工作區外路徑與不支援格式都會被拒絕，且不插入不完整語法。

在 Explorer 的 Outline 檢視顯示目前 AsciiDoc 或 Markdown 文件的標題階層。

AsciiDoc 使用 Asciidoctor AST 解析文件標題與章節；Markdown 使用 markdown-it token 解析 ATX 與 Setext 標題。

程式碼區塊中的 #、== 等文字不會被誤判為標題。

點擊標題可跳至來源文件的實際行號；文件修改後會以 debounce 更新。

支援已儲存的 file URI 與 untitled 文件，且切換編輯器時不會保留上一份文件的節點。

AdocMD Forge: Refresh Outline 可手動重新分析目前文件。

編輯或切換 AsciiDoc／Markdown 文件後，會以 debounce 檢查目前文件的本機引用。

AsciiDoc 支援 link:、xref:、<<…​>>、include::、inline／block 圖片 macro、、[#anchor] 與 。

Markdown 支援 inline link、image、heading anchor 與 {#anchor}。

會檢查檔案存在、目標是否為檔案、workspace 安全邊界與文件內 anchor；錯誤會顯示於 Problems Panel，Range 指向引用目標。

http(s)、mailto 與其他外部 URI 不進行網路探測；動態 AsciiDoc 屬性、未受信任 workspace、untitled 文件與 workspace 外路徑不讀取本機檔案。

AdocMD Forge: Validate Links 可立即重建目前文件的診斷。

Export HTML 產生完整 HTML5 文件，CSS 內嵌，工作區內圖片與連結轉為相對於輸出檔案的可攜路徑。

Export Standalone HTML 產生完整 HTML5 文件，將可讀取的工作區圖片轉成 base64 data URI，方便單獨交付。

Export Embedded HTML 只輸出經消毒的 body fragment，不包含 doctype、html、head 或 body 外框，適合嵌入其他頁面。

AsciiDoc 與 Markdown 共用既有 renderer 與 HTML sanitizer；不執行遠端網路讀取。

Export PDF 透過本機 asciidoctor-pdf 產生 PDF；可用 adocmdForge.export.asciidoctorPdfArguments 傳入 -r asciidoctor-diagram、-a data-uri、theme 與字型等參數。

匯出目的地由儲存對話框或命令參數明確指定，限制在受信任 workspace 內，不覆蓋來源文件；既有檔案需確認後才覆寫。