1667 字
8 分鐘
Markdown 編輯器怎麼選?Typora、VS Code 與部落格圖片整理

挑 Markdown 編輯器,可以先拿一篇自己正在寫的文章試:輸入標題、插入圖片、貼一段程式碼,再把檔案放進網站預覽。這幾件事做起來順不順,比功能清單長不長更有參考價值。

如果希望寫作時少看語法,可以從 Typora 開始;如果文章和網站程式碼放在同一個專案,經常需要找檔案、改設定,VS Code 會比較方便。這篇以部落格文章為例,重點放在編輯與圖片管理。

Typora 與 VS Code,先選一個把文章寫完#

寫作需求可以先試的工具實際要檢查的地方
主要寫正文,希望畫面接近文章外觀Typora貼圖方式、標題操作,以及匯出需求。
在網站專案內寫文章、改程式碼VS Code資料夾導覽、Markdown 預覽、終端機與 Git。
偶爾修改簡單文字現有文字編輯器是否以 UTF-8 儲存,副檔名是否正確。

Typora 的安裝與授權條件,請在使用前查看官網(在新分頁開啟)。這裡不把舊版試用方式當成現行授權說明。

VS Code 已有基本 Markdown 編輯與預覽功能,不必為了看標題、清單和圖片,先裝一整套外掛。Windows 可以用 Ctrl+Shift+V 開啟預覽,或用 Ctrl+K、接著按 V,在旁邊顯示預覽。VS Code 官方文件(在新分頁開啟)

用同一份範例檢查編輯器#

建立 index.md,貼入下面內容,先確認基本格式看得懂:

# 我的第一篇 Markdown 筆記
這段是一般文字,**這幾個字是重點**。
## 今天完成的事情
- 建立文章資料夾
- 寫下操作步驟
- 在網站上檢查結果
[查看 Python 官方網站](https://www.python.org/)

標題、清單和連結正常後,再練習表格與程式碼區塊。程式碼區塊要註明語言,例如 python、powershell,比較容易得到適合的語法標示。

如果是網站教學文章,操作步驟和程式碼要分開。不要把一大段說明塞進程式碼區塊,讀者複製時才不會連正文一起貼到終端機。

圖片跟著文章放,搬家比較不容易漏掉#

以 Astro 的文章資料夾為例,可以把 Markdown 和圖片放在一起:

src/content/posts/my-note/
├── index.md
├── install-window.png
└── result.png

文章中使用相對路徑:

![安裝程式的設定畫面](./install-window.png)
![執行後顯示的結果](./result.png)

./ 表示從目前 Markdown 檔案所在位置開始找。圖片與文章在同一層,就不需要把 Windows 使用者名稱或硬碟代號寫進去。

下面這種路徑只對某台電腦有意義,不適合直接放進網站文章:

C:\Users\某個帳號\Pictures\result.png

另外,/result.png 與 ./result.png 的意思不同。前者是網站根目錄路徑;在 Astro 專案裡,若採用這種公開檔案路徑,通常會對應到 public/result.png。後者則跟著文章位置走。Astro 對 Markdown 圖片與 public/ 圖片的處理方式,可查官方圖片文件(在新分頁開啟)。

Typora 的圖片設定怎麼理解?#

Typora 可以設定插入圖片時的複製位置。寫部落格時,可以選擇把圖片複製到文章附近的資料夾,再檢查產生的 Markdown 是否使用相對路徑。不同版本的設定名稱可能略有差異,操作方式以官方圖片說明(在新分頁開啟)為準。

如果文章使用網站根目錄圖片,例如 /media/example.png,Typora 可能不知道要到本機哪個網站目錄尋找。這時才需要考慮 typora-root-url,替本機預覽指定根目錄。

下面是概念範例,路徑必須換成自己的網站公開檔案目錄:

---
typora-root-url: C:/my-blog/public
---

這項設定幫 Typora 找到本機圖片,不會替網站複製圖片,也不會自動修改網站部署路徑。若文章已採用 ./圖片名稱,可以先維持同目錄管理,不必額外加上根目錄設定。

原筆記曾引用這份討論,涉及編輯器預覽行為:Markdown Preview Enhanced issue #1344(在新分頁開啟)。碰到預覽差異時,要分清楚問題發生在編輯器、外掛,還是網站本身。

VS Code 寫網站文章的基本流程#

用 VS Code 開啟整個網站資料夾,再從檔案總管找到文章位置。這樣比較容易同時看見 Markdown、圖片與網站設定。

寫一篇文章時,可以照這個順序:

  1. 建立文章資料夾與 index.md。
  2. 先填標題、日期、簡介等網站需要的資料。
  3. 寫正文,將圖片複製到文章資料夾。
  4. 用 Markdown 預覽確認基本格式。
  5. 啟動網站,在實際文章網址檢查排版。

以這個 Astro 部落格為例,本地預覽從專案根目錄執行:

Terminal window
npm.cmd run dev

編輯器預覽正常,不代表網站呈現一定相同。網站可能有自己的程式碼樣式、圖片處理、數學公式或擴充語法,最後仍要看實際頁面。

如果需要 Markdown Preview Enhanced 的功能,可以接著看站內的安裝與使用筆記。先知道缺少什麼,再決定是否加外掛,設定比較容易維護。

心智圖、筆記軟體和網頁編輯元件,別放在同一張比較表#

原筆記還列過幕布、VNote 和 TOAST UI Editor。它們可以放進不同工作流程,但選擇時應先確認用途:整理文章大綱、管理筆記,和把編輯器嵌入自己開發的網站,是不同的需求。

如果現在的問題是「如何把這篇部落格寫完」,先選能順利編輯、存圖與預覽的工具即可。網站開發需要的嵌入式編輯元件,等真的要做編輯介面時再研究。

發布前檢查這幾個地方#

把文章資料夾複製到另一個位置,再開一次圖片連結,是檢查路徑是否依賴本機環境的簡單方法。也可以用 Git 查看這次到底加入了哪些檔案,確認沒有只提交 Markdown、漏掉圖片。

再檢查圖片檔名大小寫、檔案是否真的存在,以及圖說是否能讓讀者知道畫面在說什麼。Windows 本機不容易察覺的大小寫差異,到了其他系統上可能會變成破圖。

最後用手機寬度看一次表格和程式碼。文章在編輯器裡排得整齊,到了較窄的畫面,仍可能出現太長的路徑或網址。

參考資料#

Markdown 編輯器怎麼選?Typora、VS Code 與部落格圖片整理
https://aishuafei.com/posts/markdown編輯器/
作者
愛耍廢
發佈於
2026-10-26
許可協議
CC BY-NC-SA 4.0