Markdown 語法教學
學習如何在 Markdown 文件中使用 duk.tw 圖床服務， 包含完整的語法說明和實用技巧。
📝 Markdown 圖片語法基礎
基本語法
Markdown 中插入圖片的基本語法非常簡單：
各部分的含義：
- ! - 表示這是一個圖片
- [替代文字] - 當圖片無法載入時顯示的文字，對 SEO 和無障礙很重要
- (圖片網址) - 圖片的完整網址
實例說明
假設我們有一張貓咪的照片，上傳到 duk.tw 後獲得的短網址是：
https://duk.tw/AbCdEf.jpg
那麼在 Markdown 中的寫法就是：
實際顯示效果：
🎯 duk.tw Markdown 整合說明
自動生成語法
duk.tw 會在上傳完成後自動生成正確的 Markdown 語法。你只需要：
- 將圖片拖曳或選擇上傳到 duk.tw
- 等待上傳完成
- 點擊「Markdown」分頁
- 複製生成的 Markdown 語法
- 貼到你的 Markdown 文件中
批次上傳處理
當你上傳多張圖片時，duk.tw 會為每張圖片生成對應的 Markdown 語法：
  
每行一個圖片語法，讓你的文檔井然有序。
格式支援說明
duk.tw 支援多種圖片格式，每種格式都會正確生成對應的 Markdown 語法：
- JPG/JPEG - 最常見的圖片格式，適合照片
- PNG - 支援透明背景，適合圖標和插圖
- WebP - 現代格式，提供更好的壓縮效果
- GIF - 支援動畫，適合示範和表情符號
🌐 支援的 Markdown 平台
GitHub
GitHub 是最廣泛使用 Markdown 的平台之一：
- README.md 文件
- Issues 和 Pull Requests
- Wiki 頁面
- GitHub Pages 部落格
duk.tw 生成的 Markdown 語法完美相容於 GitHub。
部落格平台
各大部落格平台都支援 Markdown：
- Medium - 直接貼上即可
- Dev.to - 支援完整 Markdown 語法
- Hugo - 靜態網站生成器
- Jekyll - GitHub Pages 官方支援
- Hexo - 熱門的中文部落格框架
文檔工具
專業文檔和筆記工具：
- Notion - 支援 Markdown 匯入匯出
- Obsidian - 原生支援 Markdown
- Typora - Markdown 編輯器
- VS Code - 程式碼編輯器，支援 Markdown 預覽
- 文檔系統 - 如 MkDocs、Docusaurus 等
💡 Markdown 進階技巧
圖片大小控制
雖然 Markdown 標準語法不支援圖片大小控制，但許多平台提供擴展語法：
<img src="https://duk.tw/AbCdEf.jpg" width="400" alt="縮小圖片">
建議使用 HTML img 標籤來精確控制圖片尺寸。
替代文字的重要性
良好的替代文字（alt text）有以下好處：
- SEO 優化 - 搜尋引擎可以理解圖片內容
- 無障礙設計 - 螢幕閱讀器可以描述圖片
- 網路問題備援 - 當圖片無法載入時顯示文字
- 語意化 - 讓文檔更具可讀性
圖片命名建議
良好的圖片檔案命名習慣：
- 使用英文或數字，避免特殊字元
- 使用描述性名稱，如
product-screenshot-2024.png - 統一命名格式，便於管理
- 考慮檔案大小，適度壓縮
🚀 實戰範例
部落格文章
在部落格文章中插入圖片的完整範例：
# 我的貓咪日記 今天帶著小橘貓去公園玩耍，真是太可愛了！  牠特別喜歡追逐落葉，看起來非常開心。  回家後累壞了，睡得香甜。 
技術文檔
在技術文檔中使用 duk.tw 的範例：
# API 文檔 ## 用戶認證流程 以下是完整的用戶認證流程圖：  ### 步驟說明 1. 用戶提交登入請求 2. 系統驗證憑證 3. 產生 JWT Token 4. 返回認證成功響應 ## 錯誤處理 當認證失敗時會返回以下錯誤： 
🔧 疑難排解
Q: 圖片無法正常顯示？
A: 請檢查網址是否正確複製，確保沒有多餘的空格。也可以嘗試在瀏覽器中直接開啟圖片網址確認。
Q: Markdown 語法不生效？
A: 不同平台對 Markdown 的支援程度不同。有些平台需要特定的語法或設定。
Q: 圖片載入很慢？
A: duk.tw 使用 CDN 加速，但網路環境可能影響載入速度。建議選擇合適的圖片格式和大小。
Q: 如何批量處理多張圖片？
A: duk.tw 支援批次上傳，會為每張圖片生成對應的 Markdown 語法。你可以在「Markdown」分頁中複製全部語法。