執行期依賴
本頁列出 NanoMD 載入時自動引入的外部資源、在全域範圍定義的名稱，以及離線或嚴格 CSP 環境需要注意的事。
自動插入的資源
bundle 一被執行，src/data.js 就在 <head> 末端插入下列元素，不需要也無法關閉：
| 資源 | 來源 | 用途 |
|---|---|---|
| Material Symbols Outlined | fonts.googleapis.com（另加 fonts.gstatic.com preconnect） |
工具列、提示框、匯出視窗圖示 |
| Mermaid 11.4.1 | cdn.jsdelivr.net/npm/mermaid@11.4.1 |
Mermaid 圖表 |
| code-prettify | cdn.jsdelivr.net/gh/google/code-prettify@master/loader/run_prettify.js |
程式碼高亮（全域 PR） |
NanoMD.css 1.11.6 |
cdn.jsdelivr.net/npm/@pardnchiu/nanomd@1.11.6 |
元件樣式 |
每個資源都附帶 preload 或 preconnect 的 <link>。document 觸發 load 時會呼叫 mermaid.initialize({ startOnLoad: false, ... }) 並在 console 印出版權資訊。
對渲染的影響
| 情況 | 結果 |
|---|---|
| CDN 無法連線（離線、內網、被 CSP 擋下） | PR 從未宣告，預覽器每 50 ms 的檢查都拋出 ReferenceError 且計時器不會停止；HTML 仍會渲染，但捲動位置不會還原、程式碼不上色、Mermaid 不轉換 |
| Mermaid 未載入 | PR 已載入但 mermaid 不存在時，每次渲染結尾拋出一次 ReferenceError；document 的 load 處理也會拋出 |
| 圖示字型未載入 | 工具列顯示圖示名稱文字（如 format_bold） |
需要離線使用時，可先在頁面放置 window.PR（自行託管的 code-prettify）與 window.mermaid，NanoMD 不會檢查來源，只看全域變數是否存在。
CSP 白名單
| 指令 | 需要允許 |
|---|---|
script-src |
https://cdn.jsdelivr.net |
style-src |
https://cdn.jsdelivr.net、https://fonts.googleapis.com、'unsafe-inline'（建構時插入 <style>） |
font-src |
https://fonts.gstatic.com |
connect-src |
https://vimeo.com（Vimeo 縮圖） |
frame-src |
https://www.youtube.com、https://player.vimeo.com |
img-src |
https://i.ytimg.com、Vimeo 縮圖網域、data: |
全域名稱
以一般 <script> 載入 NanoMD.js 時，所有頂層宣告都進入全域；以 ESM 匯入 NanoMD.esm.js 時頂層宣告留在 module 作用域，但公開類別與 window 屬性仍會寫到 window：
| 類型 | 例子 |
|---|---|
| 公開類別 | MDEditor、MDViewer、MDParser、PDMarkdownEditor、PDMarkdownViewer |
| 內部函式 | createElement、transToHTML、UUID、escapeHTML、setLink 等 |
| 內部常數 | css、deploy、cloud、isDarkMode、elementUUIDMap 等 |
window 屬性 |
_0、$0、_0_、__0、_a 等由字母表迴圈產生的短名稱 |
以一般 script 載入時，頁面上其他一般 script 若以 const／let／class 在全域宣告同名識別字（例如 createElement、css），後載入的那一支會拋出 SyntaxError: Identifier has already been declared。把自己的程式包進 module 或函式作用域即可避免。