PAHUD NOTES / STYLE GUIDELINES

讓每篇 HTML 筆記
看起來像同一個系列一份可重用的設計、寫作與實作指南

研究摘要、操作教學與互動報告,不必每次重新交代排版。先說痛點,再給結論與行動;用同一套 navy/teal 閱讀介面,把內容做得一致、好讀、好分享。

版本 1.4 · 2026-11-08 EST · 從真實已發布頁面提煉
01 / 看懂原頁規格真實色碼、字體與尺寸02 / 直接委託產生複製完整 Grok Bot prompt

THE PROBLEM

使用場景與挑戰

任務必備:正文+每篇專屬 OG 卡片

每篇新文章必須交付自包含的 index.html、同目錄獨立的 og-card.png,以及初始 head 的完整分享 metadata。正文單檔不代表分享圖可省略;不得拿本指南的圖冒當別篇的專屬卡。

當每篇筆記都換一種排版,讀者每次都得重新摸索;長篇內容沒有短結論與閱讀路線,找不到自己要的答案;而作者又得一再交代「深藍、清爽、手機可讀、按鈕可複製」。真正需要的是可重用的內容骨架與視覺規則,不只是挑一組漂亮顏色。

這份指南以 〈讓 Grok Bot 自動發布 HTML 筆記〉的實際 HTML/CSS 為基準,本頁自己也沿用相同樣式。目標是一致、好讀、可行動、好分享;它是個人筆記風格指南,不是任何平台的官方設計系統。

兩種標記,避免把建議當成既有實作

原頁實值 代表從參考頁實際 CSS 或結構提取;建議補充 代表為後續重用新增的規範。此頁不宣稱原頁或本頁已通過尚未實測的無障礙等級。

01 / PRINCIPLES

讓設計替閱讀服務

  1. 先痛點,後路線。Hero 點出對象、情境與短結論;第一張卡片回答「為什麼需要」,之後才出現閱讀路線。這是參考頁更新後的實際順序。
  2. 一張卡片,一個問題。白色 section 分隔論點;h2 是段落答案,h3 是局部任務,段落不要塞滿全部細節。
  3. 顏色有職責。深藍承載主視覺與程式碼,teal 提示連結與方向,暖色留給警告與 focus;不靠顏色單獨表達意思。
  4. 讓人帶走可操作內容。少量比較表、逐步說明、可複製 prompt 與清單,優於全篇抽象口號。
  5. 信任比裝飾重要。就近來源、查證日期、限制與未知分開說;沒有實測的操作或能力不要寫成已驗證。

第 1–4 點提煉自參考頁;「每張卡片只回答一個問題」及一致執行的寫作檢核屬建議補充,不是原 CSS 的技術限制。

02 / ORIGINAL VALUES

實際 tokens:色票、字體與空間

原頁實值 下列色值取自參考頁,不是另創的新配色。Token 在此指可重用的設計值;原頁使用直接色碼,未宣告 CSS 自訂變數。

頁面背景#f2f5f6
本文文字#203744
Hero 深海軍藍#102d40
Hero 主字#f6fbfc
Hero 輔助字#d8e5ed
Hero 副標#a3e6d4
連結#076d68
連結 hover#b45a1b
段落標籤#087c73
卡片表面#ffffff
卡片邊框#dce6e7
提示背景#eef8f5
提示側線#138675
警告背景#fff7e9
警告側線#c0842d
Focus 外框#c27c21
程式碼背景#102b3b
程式碼文字#e0f2f3
程式碼工具列#1d4254
按鈕背景#245868
按鈕邊線#78a8ad
表頭背景#163f50
次要文字#536976

字體與標題比例

原頁排版規格
層級實際值用途
本文17px / 1.85;手機 16pxsystem-ui, -apple-system, "Noto Sans TC", sans-serif
h1clamp(29px, 5vw, 46px) / 1.3;字距 -.035emHero 主結論
h1 span.74em;上距 12px定位或副標
h228px / 1.4;手機 24px;字距 -.025emsection 主題
h320px;上距 30px局部步驟
Lead/Meta20px(手機18px)/13px引言/日期與範圍
Eyebrow12px;字距 .16em;字重 750低干擾段落標籤
程式碼14px / 1.85;手機13pxui-monospace, SFMono-Regular, Consolas, monospace

字體名稱是系統 fallback stack,不代表下載了 Noto Sans TC,也不保證每台裝置顯示同一字型。原頁不載入遠端字體。

版寬、間距與圓角

03 / WRITING

標題層級與文案:先回答讀者的問題

建議補充 一篇只用一個 h1,h2 → h3 按內容層級排列,不為了字體大小跳級。段落標籤輔助掃讀,不取代可理解的中文標題。

把抽象標語改成讀者可採取的行動
避免改寫示例
全面賦能知識工作流把研究筆記變成同事點得開的網址
操作方法先確認目標站,再建立預覽版本
非常安全、永久免費不公開憑證;免費仍受當時額度與政策限制
已完美支援所有裝置已提供手機 CSS;仍須實測窄螢幕與鍵盤操作

每篇內容的最小骨架

  1. 對誰有用、現在卡在哪裡、這篇給什麼答案。
  2. 使用場景與挑戰,之後才放閱讀路線。
  3. 必要原理、具體步驟、可操作示例與限制。
  4. 發布前清單、具名可點來源、查證日期與未測項目。

可查證的事實優先用官方原始資料,重要限制就近連結。不要把推測、操作建議或資料快照寫成官方保證或自動即時更新。

04 / LIVE COMPONENTS

元件活範例:少量、清楚、有用途

本頁 hero、選項卡、閱讀路線、section、比較表與下列元件,就是沿用原頁 CSS 的實際展示;不用再疊一套不同的視覺語言。

提示與警告

提示示例:先提供可執行的下一步

需要保留的限制放在這裡,段落要短。提示使用 #eef8f5 背景、4px #138675 側線、20px 22px 內距。

警告示例:發布會改變公開內容

先確認授權與目標,保留其他文章。警告沿用 #fff7e9 背景與 #c0842d 側線,並寫出明確「警告」語意,不只改顏色。

程式碼與複製

工具列標明這是 Prompt、Command 或示例。命令使用真正可複製的純文字,不混入 shell 的提示符或秘密值。

Example · 互動複製示範
請先說明使用場景與挑戰,再給閱讀路線。
產出單檔 HTML,保留窄螢幕可讀性與鍵盤 focus。

複製按鈕成功或失敗都有狀態提示;Clipboard 被限制時嘗試 fallback,仍失敗則引導手動選取。本頁沒有因複製而送出內容到外部服務。

折疊示例:把次要細節留給需要的人

原頁以原生 details/summary 收納底層指令;本頁也用於完整 CSS。把關鍵限制留在展開外,避免讀者沒打開就錯過風險。

05 / RESPONSIVE & ACCESSIBILITY

手機、鍵盤與列印都要照顧

原頁實值 手機斷點為 @media(max-width:650px),不是另設多套任意裝置尺寸。

建議補充:不能用 CSS 存在代替測試

長表格容器可加 tabindex="0" 與可理解的區域名稱,表頭補 scope,方便鍵盤與輔助科技;本指南的表格已加這些語意。此補充不代表原頁已有相同標記。

06 / REQUIRED SHARE CARD

OG 分享卡(每篇必備)

公開文章不只要在瀏覽器好讀,還要提供分享爬蟲可讀取的標題、說明與預覽圖。本章參考 eli5 風格指南第 7 章的 PNG、中文字體與素材處理經驗,再依 Pahud Notes 的 navy/teal 體系與滿版背景規範訂定本站規範;不是照搬來源站的深色主題、全站雙語或自動索引機制。

MUST:每篇文章的交付門檻

本站標準版式:左標題、右真實畫面

每張標準分享卡都採左右雙欄。左欄放 Pahud Notes 眉標、清楚繁中主標兩行、青綠副標、2–3個tag及簡短URL;右欄優先使用與主題直接相關的一手來源、官方報導、官方產品頁,或使用者提供的相關來源網頁真實截圖;沒有清楚且可用的相關來源素材,才退回我們自己報告頁的真實viewport。不製造假介面,不用無關裝飾或AI假截圖。不必為了對齊參考卡強加英文譯文。

本站建議尺寸,不是社群平台硬限制
區域配置要求
左欄約58–60%畫布寬主標約56–64px,副標約28–32px,字長過長先分行
右欄約35–38%畫布寬優先相關來源網頁真實截圖,無合適來源才用自家報告viewport;等比例fit,不拉伸
安全間距外距約48–64px、欄間約24–36px畫布內留白;可依內容調整,不加白外框
頂部線全寬青綠線約8–10px例如#7de0c7;其餘背景滿版深藍

先尋找/取得主題直接相關的來源頁素材,依下列優先序選圖並記錄URL、來源與擷取時間,再以程式讀檔合成。不要預設使用自家報告頁;確認沒有清楚且可用的相關來源圖後,才以自家報告真實viewport作fallback,仍維持雙欄,不退回無關裝飾或虛構畫面。可裁去截圖下緣浮動徽章或捲軸,不改造頁面事實;保持裁後長寬比,縮圖後仍可辨識hero/標題。右欄允許內部深色容器、細青綠框與適度內圓角;禁止的是整張圖的白外框與外層圓角,不是截圖框。

右欄素材優先序:相關來源優先,自家截圖備援

  1. 優先一手與官方:選與文章主題直接相關的原始報導、研究原文、官方產品頁,或使用者提供的相關來源頁真實截圖。保住可辨識的標題、產品或人物與內容脈絡;不可只裁成無從辨識來源的一張臉。
  2. 先確認可公開與可用:記錄原頁URL、素材提供者/擷取方式與必要來源標註;有授權、隱私或使用限制時依其要求處理。不要公開登入後私人頁、個資、token或內部畫面;使用者給圖不代表能忽略圖片中的私人內容。
  3. 無合適來源才fallback:若相關來源圖找不到、太模糊、無法合法公開或無法保留主題識別,才使用本篇報告自己的真實viewport。這是備援,不是每篇預設;不用AI假截圖、拼造官方UI或隨便無關圖片湊版。

所有素材都等比例fit,不刪改畫面標題/作者或編造影片字幕,不把靜態海報當成已觀看影片的證據。縮小後若只能辨識人物與頁面主題,需如實描述,不宣稱小字都清晰可讀。來源截圖內的白色頁底不是整張分享卡的白外框。

建議:沿用自己的配色與留白

自訂設計建議 主視覺必須使用 #102d40 不透明滿版深藍底,頂部加全寬青綠細線,其餘邊緣維持深藍;不畫白框、淺色外底或整張外層圓角。Teal #138675/#a3e6d4 用於文字與內部 tag;平台可能自行裁切,但圖片本身不畫外殼。文字安全間距留在深藍畫布內,不是淺色外框;距畫布邊緣建議至少 64px,主標可從約 64px 起試,副標約 28–40px,tag 控制在 2–3 個;依實際字長調整,勿縮到不可讀。這些不是 X 或其他平台硬限制。

檔案大小以約 1–2MB 以內作自訂目標,能更小更好,但不是平台保證或統一上限。本頁實作約 47KB。平台仍可能裁切或快取;安全邊距只能降低風險,不保證所有預覽長相一致。

Pahud Notes HTML 筆記風格指南:一致、好讀、好分享;設計、寫作、實作與 OG 分享卡。
本指南專屬卡片示範:1200×630深藍滿版、頂部青綠線;左標題右真實指南viewport截圖,無整張白框。素材擷取於本次更新前,故可見當時的版本標籤,不代表另一套即時頁面。

條件適用:雙語與產品圖

中文轉圖與實際目視

製圖端需真的安裝繁中文字體,例如 Noto Sans CJK TC;SVG→PNG 前可用 fontconfig 確認對應,或像本頁用 Pillow 指定實際 TC 字體。本頁使用本機 Noto Sans CJK TC 產製,轉出後須目視 PNG,另縮小檢查留白、裁切與字形;網頁系統字體 stack 不代表製圖工具也有該字體。

可複製:本指南真實 head 範例

下面是本頁自己的完整 OG/Twitter 範例。新文章必須替換所有標題、說明、alt、頁面與圖片 URL,不能照抄本頁網址。

HTML · 本指南最終網址範例
<link rel="canonical" href="https://pahud-notes.netlify.app/gudelines/">
<meta name="description" content="Pahud Notes 的繁中 HTML 風格指南:真實 CSS、寫作骨架、元件範例與每篇必備的 1200×630 OG 分享卡。">
<meta property="og:title" content="HTML 筆記風格指南:可重用的設計、寫作與實作規範">
<meta property="og:description" content="Pahud Notes 的繁中 HTML 風格指南:真實 CSS、寫作骨架、元件範例與每篇必備的 1200×630 OG 分享卡。">
<meta property="og:type" content="article">
<meta property="og:url" content="https://pahud-notes.netlify.app/gudelines/">
<meta property="og:image" content="https://pahud-notes.netlify.app/gudelines/og-card.png?v=506b2ef3f943">
<meta property="og:image:type" content="image/png">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:image:alt" content="HTML 筆記風格指南:左側標題、設計寫作實作與標籤,右側為真實指南頁面截圖。">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="HTML 筆記風格指南:可重用的設計、寫作與實作規範">
<meta name="twitter:description" content="Pahud Notes 的繁中 HTML 風格指南:真實 CSS、寫作骨架、元件範例與每篇必備的 1200×630 OG 分享卡。">
<meta name="twitter:image" content="https://pahud-notes.netlify.app/gudelines/og-card.png?v=506b2ef3f943">
<meta name="twitter:image:alt" content="HTML 筆記風格指南:左側標題、設計寫作實作與標籤,右側為真實指南頁面截圖。">
分享預覽不保證立刻刷新

先查頁面 metadata、圖檔、權限與內容類型,再視需要用對應平台 debugger 要求重抓;不同平台可能快取、裁切或延遲,不能未查原因就歸咎某一平台快取,也不能保證重新抓取一定立即出卡。

07 / IMPLEMENTATION

可重用的單檔 HTML 實作

先保留內容骨架,再使用原 CSS;CSS 不依賴框架、CDN 或外部字型。所謂「單檔 HTML」指正文的 CSS/JS 自包含、沒有遠端執行依賴;供分享爬蟲抓取的 og-card.png 必須另檔同目錄發布,不能以 data URI 或僅 SVG 代替。這不是完整元件函式庫,新增元件時仍需檢查溢出與語意。

HTML 骨架:複製後填入自己的內容
Template · 基本語意骨架
<!doctype html>
<html lang="zh-Hant">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width,initial-scale=1">
  <meta name="description" content="一句話說清楚讀者可得到什麼">
  <title>主題:讀者可採取的行動</title>
  <!-- 必填佔位:發布前替換 YOUR-SITE、YOUR-SLUG 與所有本篇文案 -->
  <link rel="canonical" href="https://YOUR-SITE.netlify.app/YOUR-SLUG/">
  <meta property="og:title" content="請替換:本篇主標">
  <meta property="og:description" content="請替換:本篇摘要">
  <meta property="og:type" content="article">
  <meta property="og:url" content="https://YOUR-SITE.netlify.app/YOUR-SLUG/">
  <meta property="og:image" content="https://YOUR-SITE.netlify.app/YOUR-SLUG/og-card.png">
  <meta property="og:image:type" content="image/png">
  <meta property="og:image:width" content="1200">
  <meta property="og:image:height" content="630">
  <meta property="og:image:alt" content="請替換:本篇圖片說明">
  <meta name="twitter:card" content="summary_large_image">
  <meta name="twitter:title" content="請替換:本篇主標">
  <meta name="twitter:description" content="請替換:本篇摘要">
  <meta name="twitter:image" content="https://YOUR-SITE.netlify.app/YOUR-SLUG/og-card.png">
  <meta name="twitter:image:alt" content="請替換:本篇圖片說明">
  <style>/* 貼入下方原頁 CSS;不引用遠端樣式 */</style>
</head>
<body>
  <header class="hero">
    <p class="eyebrow">PRACTICAL GUIDE</p>
    <h1>一句主標<span>一句定位</span></h1>
    <p class="lead">讀者場景、痛點與短結論。</p>
    <div class="meta">查證日期與範圍</div>
  </header>
  <main>
    <section id="problem"><h2>使用場景與挑戰</h2><p>為何需要這篇?</p></section>
    <nav aria-label="文章目錄"><b>閱讀路線</b><a href="#steps">開始操作</a></nav>
    <section id="steps"><h2>具體步驟</h2><p>內容與就近引用。</p></section>
    <section id="sources"><h2>參考來源</h2><p>可點擊的原始來源。</p></section>
  </main>
  <footer>獨立筆記;限制與未測項目如實標示。</footer>
</body>
</html>
<!-- 同目錄另附本篇專屬 1200×630 og-card.png;正文 CSS/JS 仍自包含。 -->
原頁完整 CSS:可直接複製的實際基線

以下為參考頁 CSS 原值,未把本指南新增的色票網格樣式冒充為原規格。

CSS · 原頁完整樣式
*{box-sizing:border-box}html{scroll-behavior:smooth;scroll-padding-top:20px}body{margin:0;background:#f2f5f6;color:#203744;font:17px/1.85 system-ui,-apple-system,"Noto Sans TC",sans-serif}a{color:#076d68;text-underline-offset:4px}a:hover{color:#b45a1b}button,a,summary{-webkit-tap-highlight-color:transparent}:focus-visible{outline:3px solid #c27c21;outline-offset:4px}header,main,footer{max-width:1000px;margin:auto}.hero{background:#102d40;color:#f6fbfc;padding:60px 56px 40px;border-radius:0 0 28px 28px}.eyebrow{font-size:12px;letter-spacing:.16em;font-weight:750;color:#087c73}.hero .eyebrow{color:#7de0c7}h1{font-size:clamp(29px,5vw,46px);line-height:1.3;letter-spacing:-.035em;margin:15px 0 24px}h1 span{display:block;color:#a3e6d4;font-size:.74em;margin-top:12px}.lead{font-size:20px;max-width:720px;color:#d8e5ed}.meta{font-size:13px;color:#afc6d4}.choices{display:grid;grid-template-columns:1fr 1fr;gap:14px;margin-top:30px}.choices a{color:#fff;border:1px solid #4d7484;border-radius:12px;padding:16px 20px;text-decoration:none;background:#183d50}.choices b,.choices span{display:block}.choices span{font-size:14px;color:#bfe1e5}main{padding:20px 40px}nav{display:flex;flex-wrap:wrap;gap:9px 18px;padding:18px 10px;border-bottom:1px solid #cfdddf;font-size:14px}section{margin:28px 0;background:#fff;border:1px solid #dce6e7;border-radius:18px;padding:36px}h2{font-size:28px;line-height:1.4;margin:5px 0 22px;letter-spacing:-.025em}h3{font-size:20px;margin-top:30px}p{margin:14px 0}li{margin:12px 0}ol,ul{padding-left:25px}strong{color:#123f50}.small{font-size:14px;color:#536976}.tablewrap{max-width:100%;overflow-x:auto;border:1px solid #d7e4e6;border-radius:10px}table{border-collapse:collapse;width:100%;min-width:580px;font-size:15px}caption{text-align:left;padding:12px 18px;font-weight:bold;background:#edf5f4}th,td{text-align:left;vertical-align:top;padding:13px 16px;border-bottom:1px solid #dce6e7}thead th{background:#163f50;color:#fff}tbody th{white-space:nowrap;background:#f3f7f7}.notice{background:#eef8f5;border-left:4px solid #138675;padding:20px 22px;margin:24px 0;border-radius:0 10px 10px 0}.notice p{margin-bottom:0}.danger{background:#fff7e9;border-color:#c0842d}.snippet{margin:20px 0;border:1px solid #315165;border-radius:12px;overflow:hidden;min-width:0;background:#102b3b;color:#e0f2f3}.codebar{display:flex;justify-content:space-between;align-items:center;gap:10px;background:#1d4254;padding:10px 14px;font-size:13px}.codebar button{border:1px solid #78a8ad;color:#fff;background:#245868;padding:6px 13px;border-radius:6px;font:inherit;cursor:pointer;flex-shrink:0}.codebar button:hover{background:#087b72}pre{font:14px/1.85 ui-monospace,SFMono-Regular,Consolas,monospace;margin:0;padding:20px;overflow-x:auto;tab-size:2}p code,li code{font-size:.85em;background:#eaf1f2;padding:2px 5px;border-radius:4px;overflow-wrap:anywhere}pre code{background:none}.ref{font-size:12px;margin-left:4px;white-space:nowrap}.closing{margin-top:30px;padding:22px;background:#143d4e;color:white;border-radius:10px}.sources{font-size:15px;overflow-wrap:anywhere}details{border:1px solid #d7e4e6;border-radius:10px;padding:15px}summary{cursor:pointer;font-weight:650}.checklist{list-style:"✓  ";padding-left:26px}.checklist li::marker{color:#087c73}footer{text-align:center;padding:25px 25px 50px;color:#5c7180;font-size:13px}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}@media(max-width:650px){body{font-size:16px}.hero{padding:36px 24px;border-radius:0 0 20px 20px}.lead{font-size:18px}.choices{grid-template-columns:1fr}main{padding:10px 12px}section{padding:25px 19px;margin:20px 0}h2{font-size:24px}.notice{padding:16px}pre{padding:15px;font-size:13px}nav{gap:10px 15px}}@media(prefers-reduced-motion:reduce){html{scroll-behavior:auto}}@media print{body{background:#fff;color:#111;font-size:11pt}.hero{background:#fff;color:#111;padding:20px}.hero .eyebrow,h1 span,.lead,.meta{color:#333}main{padding:0}section{border:0;padding:10px 15px;break-inside:auto}.choices,nav,button,footer{display:none}h2,h3{break-after:avoid}.snippet{color:#111;background:#f5f5f5;border-color:#aaa}.codebar{background:#eee;color:#111}pre{white-space:pre-wrap;overflow-wrap:anywhere}table{min-width:0}thead th{background:#eee;color:#111}a{color:#111}details{display:block}.notice,.closing{background:#f5f5f5;color:#111}.tablewrap{overflow:visible}}
可選重構:將實值抽成 CSS variables
CSS · 建議補充,非原頁變數
/* 建議補充:將原頁實際色值抽成變數;原頁本身未用 CSS variables */
:root {
  --page: #f2f5f6;
  --ink: #203744;
  --navy: #102d40;
  --link: #076d68;
  --surface: #ffffff;
  --border: #dce6e7;
  --focus: #c27c21;
  --content-max: 1000px;
  --card-radius: 18px;
}
/* 新文章採用時逐步替換,勿誤稱原頁已使用這些 token 名稱。 */
複製互動 JS:連同狀態區與按鈕使用

按鈕加 data-copy="目標ID",pre 使用相同 id;頁尾加 id="copy-status"、role="status"、aria-live="polite" 的 sr-only 元素。所有 ID 必須唯一。

JavaScript · 原頁複製互動
document.querySelectorAll('[data-copy]').forEach(function(button){button.addEventListener('click',async function(){const text=document.getElementById(button.dataset.copy).textContent;let ok=false;try{if(navigator.clipboard&&window.isSecureContext){await navigator.clipboard.writeText(text);ok=true;}}catch(error){}if(!ok){const area=document.createElement('textarea');area.value=text;area.style.position='fixed';area.style.opacity='0';document.body.appendChild(area);area.focus();area.select();try{ok=document.execCommand('copy');}catch(error){}area.remove();button.focus();}button.textContent=ok?'已複製':'請手動選取複製';document.getElementById('copy-status').textContent=ok?'內容已複製到剪貼簿。':'瀏覽器未允許複製,請選取程式碼區內容手動複製。';window.setTimeout(function(){button.textContent='複製';},2500);});});

08 / COPY & REUSE

直接複製給 Grok Bot 的完整 prompt

先填主題、讀者與行動。這份 prompt 會把視覺、寫作、查證與安全發布要求一起帶走;不會自動授權公開任何新內容。

Prompt · 產生同系列筆記
請依照這份獨立風格指南製作繁體中文 HTML 筆記:
https://pahud-notes.netlify.app/gudelines/
參考原實作:https://pahud-notes.netlify.app/grok-bot-public-notes/

主題:[填入主題];讀者:[填入對象];希望讀者採取的行動:[填入行動]。
先閱讀指南,不把它當官方平台規格。保留 navy/teal、適中版寬、白色圓角卡片、清楚閱讀路線、原頁字級與行距。
內容順序:hero短結論與使用情境 → 使用場景與挑戰 → 閱讀路線 → 核心解釋與具體步驟 → 適量比較表/提示/範例 → 可複製指令或prompt → 檢查清單 → 來源。
先說讀者痛點,再給路線;一個h1,依序h2/h3,不以大段行話或裝飾取代結論。
對可查證事實優先閱讀官方原始來源,重要限制就近引用,標記查證日期;區分事實、建議、未知與未實測,不造數字、引用或無障礙達標宣稱。

交付正文自包含的單檔HTML,另附本篇專屬1200×630 PNG og-card.png;圖片獨立同目錄公開,不用data URI或僅SVG,也不借別篇圖片URL。
初始head必須有canonical、description、og:title/description/type/url/image及image:type/width/height/alt,以及twitter:card=summary_large_image、twitter:title/description/image/image:alt;頁與圖片網址用最終絕對HTTPS,不等JS注入。
OG卡必須標準左右雙欄:左約58–60%放品牌、繁中兩行大標、副標、少量tag及URL;右約35–38%優先放主題直接相關的一手原文/官方報導/產品頁,或使用者提供相關source頁的真實截圖;找不到清楚、可用且可公開的相關來源圖,才fallback本篇報告真實viewport,不預設使用自家頁。記錄來源URL、擷取方式與時間,必要時標註;不得公開登入私人頁或個資。保留主題標題/產品/人物識別,保比例、不壓字,不偽造UI、不編造字幕、不用無關裝飾或AI假截圖。尺寸比例是本站建議非平台硬限制。使用#102d40不透明滿版深藍底與頂部全寬青綠細線,無整張白框/淺色外底/外層圓角;右欄內部深色容器可有細框及適度內圓角。文字安全間距留在深藍畫布內,本站navy/teal配色、清楚主副標、少量tag與Pahud Notes識別,適度留白;確保真實繁中文字體、無裁切/方框並目視PNG。僅雙語文章需兩語同圖,產品照選用且保比例;白底素材不強去背。
正文CSS/JS內嵌、無CDN/遠端字體/追蹤/表單;使用語意標籤、精確title/description/canonical、unique IDs、可點錨點、鍵盤focus、減少動態效果。
程式碼及長表格只在自身區域橫捲,手機<=650px改單欄;提供列印CSS。複製按鈕須有成功/失敗提示與Clipboard不可用時的fallback,內容本身可手動選取。
檢查JS語法、錨點、copy targets、遠端依賴與手機CSS;瀏覽器未測項目如實標註。

若本次另有明確發布授權,只部署指定網站及路徑;先讀目前production完整檔案並保留原首頁與所有文章,合併完整乾淨快照,draft驗證後再production,正式發布前檢查deploy ID避免並行覆蓋。
無法確認舊內容完整保留就停止。未授權發布則只交付HTML,不自行公開。
憑證僅用合法授權安全機制;不在HTML、聊天、命令列明文、來源碼或公開log放token/claim連結/私人資料。
發布後驗證精確URL的HTTP200、text/html、bytes match及其他檔案hash不變;回報本地檔、公開URL、PNG路徑、deploy ID與QA,不聲稱未做的瀏覽器測試。
發布前檢查頁與圖HTTP200及text/html、image/png、PNG解析尺寸、metadata唯一、bytes match與索引;分享平台可能快取或裁切,不保證即時出卡。
圖片本名維持og-card.png,可用固定內容hash的?v=版本query降低舊圖快取;og:image/twitter:image一致,正文圖預覽也更新。這不保證社群重抓原文章URL。白底產品圖可放內部素材區,不能因此加整張白外框。

09 / BEFORE YOU PUBLISH

發布前 checklist

一致的是閱讀體驗,不是每篇都長一樣

沿用骨架、色彩職責與安全底線,讓內容決定需要哪些表格、提示與示例;不要為了湊元件把短筆記拉成長報告。

REFERENCE & SCOPE

依據與適用範圍

新增參考:eli5 風格指南第 7 章・OG 分享卡 ↗(2026-11-08 EST 閱讀)。採納圖片尺寸、中文轉圖目視與素材處理經驗;不照搬其配色、自動索引、全站雙語與對快取原因的概括說法。

參考原頁:讓 Grok Bot 自動發布 HTML 筆記 ↗

本指南於2026-11-08 EST從上述頁面的實際原始 HTML/CSS 提煉,基準是本次生成時的頁面;未來原文更新不會自動同步此指南。色票網格、原值/建議標籤、表格鍵盤區域與本頁內容為指南新增,主體風格與複製互動沿用原實作。

本頁沒有提供色彩對比數字或無障礙等級保證。程式化 QA 與瀏覽器視覺/操作測試是不同階段,不能互相替代。發布教學請回原文,這份文件專注設計與寫作規範。