跳到主要內容

文案是寫給用戶看的,不是寫給工程師看的

把技術細節翻譯成使用者關心的結果、按鈕與錯誤訊息的寫法、空狀態三種講法,以及一份可以直接套的檢查表。

約 4 分鐘 · writing-for-users.md

1. 最常見的病:介面在描述系統,不是在描述使用者的世界

AI 產生的文案幾乎都有這個問題,因為它在描述它剛剛實作的東西。

✗ 使用先進的 AI 模型自動處理您的音訊檔案
✓ 影片丟進來,字幕自己會好

✗ 支援多種格式的資料匯出功能
✓ 匯出成 SRT、VTT,剪輯軟體直接吃

✗ 高效能的雲端運算架構
✓ 20 分鐘的影片,大概三分鐘處理完

✗ 資料同步失敗
✓ 存檔沒成功,你剛才打的字還在,網路恢復後會自動再試一次

判準:這句話講的是「我們做了什麼」還是「你會得到什麼」?

2. 首頁的結構

標題    使用者想要的結果(不是產品類別)
副標    怎麼做到的,一句話
按鈕    一個動詞,講他要做的事
小字    消除他正要提出的疑慮
上字幕這件事,交給機器就好。
丟進影片,聽打、斷句、對時間全自動完成。你只要看一遍,改幾個字。
[ 免費開始 ]
影片留在你的電腦・不用信用卡・兩分鐘上手

小字那一行常被省略,但它是轉換率差異最大的一行 —— 它回答了使用者正要問的問題。

3. 按鈕

情境 不要
送出表單 提交 建立專案
確認刪除 確定 永久刪除專案
開始使用 點擊這裡 免費試一支影片
取消 取消

原則:

  • 按鈕文字要能單獨看懂。螢幕閱讀器使用者可以只聽按鈕列表,「點擊這裡」對他們是零資訊
  • 描述會發生什麼,不是描述動作本身
  • 危險操作要說出後果:「永久刪除」不是「刪除」
  • 一組動作只有一個主要按鈕

4. 錯誤訊息的三個部分

  1. 發生什麼(用他們的話)
  2. 是誰的問題(幾乎都是我們的 —— 這句要說出來)
  3. 現在可以做什麼
✗ 發生錯誤,請稍後再試
✓ 上傳失敗:檔案超過 2GB。請先壓縮,或改用桌面版上傳工具。

✗ Invalid input
✓ 這個電子郵件看起來不完整,要有 @ 和網域,例如 yijun@example.com

✗ 403 Forbidden
✓ 你沒有這個工作區的權限。請工作區管理員把你加進成員清單。

不要責怪使用者。 「您輸入的資料有誤」和「這個格式我們讀不出來,要不要試試 YYYY-MM-DD」,同樣的意思,完全不同的感受。

5. 空狀態有三種,講法完全不同

狀態 語氣 例子
還沒建立 教學 + 邀請 「上傳一支影片,我們會自動產生字幕。第一支免費。」
搜尋無結果 提供出路 「找不到『街訪 2024』。試試拿掉『已完成』這個篩選。」
沒有權限 說明怎麼取得 「你沒有這個工作區的權限。請管理員把你加進成員清單。」

三種用同一張插圖配「沒有資料」,是把三個不同的問題當成同一個。

6. 載入中要說在做什麼

✗ 載入中…
✓ 正在辨識語音(第 2 步,共 3 步)…
✓ 已處理 12 / 48 分鐘

超過 10 秒的操作必須顯示進度或步驟,否則使用者會以為當掉了。

7. 數字要有脈絡

✗ 94% 準確率
✓ 94% 的字幕不用再手動修

✗ 處理速度提升 3.2 倍
✓ 20 分鐘的影片,以前要花你一個半小時,現在大概八分鐘

8. 什麼時候可以講技術

技術詞彙不是絕對禁止,取決於讀者:

  • 開發者工具:講 API、SDK、webhook 是對的,講「輕鬆整合」反而空洞
  • 一般消費者:講「加密傳輸」可以,講「AES-256-GCM」沒有幫助
  • 企業採購:講 SOC 2、SLA 是必要的

判準:你的讀者會用這個詞跟同事描述這件事嗎? 會,就用;不會,就翻譯。

9. 中文文案的細節

  • 不要用全形英文標點混排(這樣) 不要寫成 (這樣) 除非兩邊都是中文
  • 數字用半形,並在中英之間留一個空白(或交給字體處理)
  • 避免翻譯腔:「請您點擊下方之按鈕以進行提交」→「按下面的按鈕送出」
  • 不要用「您」用到很生硬。台灣的產品文案用「你」通常更自然,除非是金融或政府
  • 句子短一點。一個句子講一件事

10. 法務頁也要寫給人看

服務條款和隱私權政策通常沒人看,因為寫得像判決書。做兩件事就會有人看:

  1. 每一節開頭給一句白話摘要
  2. 先講使用者最在意的:「這個站不需要註冊、不做行為廣告追蹤、只存一個記住顯示偏好的 cookie。」

11. 檢查表

把這份貼給 AI,讓它檢查你的文案:

請檢查這些文案,逐條回答:

1. 標題講的是使用者得到的結果,還是我們做了什麼?
2. 有沒有使用者不會用的詞(架構、賦能、解決方案、無縫、一站式)?
3. 每個按鈕單獨看得懂嗎?
4. 錯誤訊息有沒有講「怎麼修」?
5. 有沒有責怪使用者的語氣?
6. 空狀態有沒有分成三種情況?
7. 數字有沒有脈絡?
8. 超過 10 秒的操作有沒有進度?
9. 有沒有翻譯腔?

把每一條不合格的原句和建議改法列出來。

顯示設定

這裡改的每一項,會即時套用到站上所有預覽。

風格

密度

圓角

動態

系統層級的「減少動態效果」永遠優先於這裡的設定。

語言