【網站範例】用 Markdown 呈現教學、圖片與影片

在這篇文章試試提示、步驟、頁籤與收合說明,接著點開圖片、比較圖片組,再播放一段短片。所有範例都由 Markdown 正文產生,沿用部落格的共用閱讀版型。

想先試目錄?直接跳到 macOS 頁籤裡的收合段落,觀察網站如何顯示原本隱藏的內容。

四種提示,各有清楚的用途

每種提示都有不同的圖示,螢幕閱讀器也能讀出狀態名稱。即使不靠顏色,也能分辨提示的種類。

跟著步驟試一次

  1. 先閱讀提示

    往上比較四種提示的圖示與內容。粗體、連結與清單都可以繼續使用一般 Markdown。

  2. 再切換不同內容

    試試下一節的 Windows 與 macOS 頁籤。接著操作「快速版/詳細版」那一組,確認兩組頁籤各自保留選擇。

  3. 最後打開補充說明

    點擊「這裡還能放什麼?」。也可以用鍵盤 Tab 移到標題,再按 Enter 或空白鍵。

同一篇教學,提供不同閱讀路徑

Windows

Windows 閱讀範例

你現在看到的是第一個頁籤,這也是每一組頁籤預設顯示的內容。

macOS

macOS 閱讀範例

這是第二個頁籤的獨立正文。下面還藏了一段補充說明。

展開 macOS 的補充說明

原本藏起來的段落

你已找到同時位於頁籤與收合說明中的段落。從本篇目錄,或帶有 #hidden-note 的網址進入時,網站會先切換頁籤、展開說明,再定位到這裡。

下面是另一組頁籤,可以獨立操作:

快速版

先讀提示,再切換平台,最後展開說明。

詳細版

想試的操作 可以觀察的結果
切換這組頁籤 上方的平台選擇保持原樣
點擊目錄中的隱藏段落 對應頁籤與收合說明自動顯示
用鍵盤操作 頁籤與收合標題都有可辨識的焦點

把補充資訊收起來

這裡還能放什麼?

可以放讀者視需要才閱讀的補充資訊,例如:

  • 額外的操作說明。
  • 常見問題與排查方向。
  • 表格、程式碼,或需要特別提醒的提示區塊。

停用 JavaScript 時,這個收合區塊仍能操作;所有頁籤正文也會依序顯示。

點一下,看看圖片細節

先點這張設計素材板。放大後可以查看原圖,按 Esc 回到文章。使用鍵盤時,以 Tab 移到圖片,再按 Enter 或空白鍵開啟。

米白色素材板上排列著暖色、冷色兩張抽象海報與配色色票

這張圖片使用最普通的 Markdown 圖片寫法。替代文字用來描述畫面,不會自動變成可見圖說。

讓圖說補上畫面沒說完的事

陶土橘海報上有半圓拱門、圓形與米白色線條
暖色版本以陶土橘為主。這段可見圖說支援粗體、連到同頁的圖片組與 行內程式碼。

點開任一張圖片,試試上一張、下一張,或鍵盤的左右方向鍵。這組只有暖色與冷色兩張,切換時不會混入後面的長圖組。

暖色抽象海報,使用陶土橘、奶油白與深褐色
暖色版本:柔和的橘色與圓弧。
冷色抽象海報,使用深藍、淺藍與薄荷綠
冷色版本:藍色塊面與清楚的留白。

長圖也能慢慢讀

這是另一組圖片。打開左邊的長圖,點右上角的縮放圖示,再拖曳或使用滑鼠滾輪閱讀。手機可以雙指縮放,放大後再拖曳。下方圖說較長時,也能獨立捲動;關閉後會回到原本點開的位置。

由上而下列出開啟圖片、比較版本、播放影片與閱讀說明四個步驟的長圖
這張長圖刻意保留完整高度,方便檢查手機與桌面上的閱讀感受。圖片不會被裁成固定尺寸。你可以先配合視窗查看全貌,再切換成完整長圖,逐段閱讀。最後一個步驟在圖片底部,捲到底就能看見。

這組的第二張圖片是一整張設計素材板

播放一段真的影片

按下播放後,試試暫停、拖曳進度或全螢幕。這段短片沒有旁白;示範字幕是另外加入的操作提示,可以在播放器的字幕選單切換。

開啟原始影片

MP4 短片使用本篇文章的素材檔案。封面、字幕和原始影片連結也都在本站,可以直接操作播放器。
也試試 WebM 格式

開啟原始影片

相同畫面的 WebM 版本。這也示範了影片放在收合說明中,展開後仍能播放。

決定什麼時候載入外部播放器

下方一開始只有名稱、說明與入口。按「載入 YouTube 播放器」後,才會連線至 YouTube;你也可以直接前往原網站觀看。

YouTube 官方播放器範例

載入 YouTube 播放器

前往 YouTube 觀看

這支影片只用來示範外部嵌入,不是 Eagle 的產品影片。能否在此播放,也取決於 YouTube 的服務與影片擁有者設定。

把這些元件用在自己的文章

到知識庫的Markdown 教學元件、圖片與影片寫法範例,可以逐段比較效果與可複製的寫法。知識庫使用固定閱讀版型,提供相同的互動能力。

素材來源

圖像為本站製作的示意素材。花朵影片來自 MDN 的 CC0 影片素材,依其 CC0 授權使用;示範字幕由本站撰寫。

搜尋網站內容

輸入關鍵字,尋找頁面或文章。

↑ ↓ 選擇 · Enter 開啟內容 · Esc 關閉