查看系列函式庫KatanADesktop

閱讀、確認、分享。

把往返文件的時間,留給思考。

從 README、設計圖到 PDF 與 Office 資料,KatanA 都能在同一個工作區開啟專案文件,進行閱讀、編輯與分享。

macOS Windows Linux GitHub
KatanA 並排顯示檔案樹、Markdown 原始碼與預覽的畫面KatanA 並排顯示檔案樹、Markdown 原始碼與預覽的畫面
保留專案脈絡,在檔案與檢視畫面之間切換。

01

從手邊的文件立即開始。

不需要移到新的儲存位置。開啟本機專案,依照目的選擇閱讀方式。

讓儲存庫成為易讀的工作空間。

透過檔案樹與分頁查看 README、規格說明和補充資料。工作區搜尋以 Markdown 為對象,可依大小寫、完整單字與正規表示式縮小範圍。

  1. 將包含文件的資料夾作為工作區開啟。
  2. 從檔案樹選取文件,相關資料在其他分頁開啟。
  3. 使用文件內搜尋或 Markdown 工作區搜尋,前往需要確認的位置。

以資料夾結構為線索,在同一個工作空間中對照閱讀相關文件。

KatanA 的檔案樹與選取的 README 預覽KatanA 的檔案樹與選取的 README 預覽

同時確認原始碼與顯示結果。

分割顯示 Markdown 原始碼與預覽,確認文字和語法的修改。分割方向、面板排列與目錄都可依工作需求調整。

  1. 開啟 .md 或 .markdown,切換為原始碼與預覽的分割顯示。
  2. 編輯文字或標題,確認預覽中的顯示變化。
  3. 確認內容並儲存;需要時匯出為 HTML、PDF、PNG 或 JPEG。

先在畫面確認編輯內容,再明確執行儲存。不要假設會自動儲存,請完成儲存操作。

KatanA 並排顯示 Markdown 原始碼與轉換結果的分割畫面KatanA 並排顯示 Markdown 原始碼與轉換結果的分割畫面

讓設計圖和文字處於相同脈絡。

轉換 Markdown 中的 Mermaid、PlantUML 與 Draw.io。在用其他工具單獨開啟圖表之前,先確認它與說明文字的關聯。

  1. 在 Markdown 程式碼區塊指定 mermaid、plantuml 或 drawio 語言。
  2. PlantUML 準備 @startuml / @enduml,Draw.io 準備未壓縮 XML。
  3. 在預覽中確認圖表及前後說明,必要時匯出文件。

可以一起檢閱圖表定義與說明文字。支援的語法和輸入格式條件,請參閱下方格式說明。

KatanA 顯示 Markdown 中多個圖表的畫面KatanA 顯示 Markdown 中多個圖表的畫面

02

格式不同,工作空間仍然一致。

並非所有格式都能用相同方式編輯。這裡依格式說明可執行的操作與輸入條件。

HTML

支援顯示 HTML 文件與編輯原始碼。它使用不同於 Markdown 的 HTML 預覽路徑,可以一邊確認現有 Web 資料一邊編輯。

變更內容會透過儲存操作寫回檔案。

PDF / Word

使用專用文件預覽開啟 PDF 與 Word(DOCX),在頁面間移動查看。

僅供檢視,不能直接編輯 PDF 或 DOCX 內文。

Excel / PowerPoint

可以切換工作表查看 Excel(XLSX),切換投影片查看 PowerPoint(PPTX)。

僅供檢視,不能取代 Office 應用程式的所有編輯和顯示功能。

Mermaid / PlantUML

從 Markdown 程式碼區塊轉換圖表。指定 mermaid 或 plantuml,並以開始與結束指令包住 PlantUML 輸入。

PlantUML 需要 @startuml / @enduml。

Draw.io

在 drawio 程式碼區塊放入未壓縮 XML 即可轉換圖表。使用前請確認輸入格式。

需要包含 <mxfile> 或 <mxGraphModel> 的未壓縮 XML。

03

開啟第一份文件,只需 3 步。

先從平時使用的專案 README 開始。用現有檔案試試不同的閱讀方式。

  1. 取得適用作業系統的發行檔案。

    可透過下方 macOS、Windows、Linux 按鈕直接取得公開發行檔案。安裝方法請在專門頁面確認。

  2. 開啟包含文件的資料夾。

    將專案資料夾作為工作區開啟。需要時可設定探索深度、排除目錄與顯示副檔名。

  3. 閱讀、確認、分享。

    從樹狀結構選取文件,使用分頁、搜尋和分割顯示繼續閱讀。匯出 Markdown 時,請依分享對象選擇輸出格式。

04

開始前需要知道的事項。

不只說明可以做什麼,也明確交代處理檔案時的界線。

Office 與 PDF 用於檢視。

二進位文件支援 PDF、DOCX、XLSX、PPTX。它們以預覽模式開啟,不等同於 Office 應用程式的編輯功能。

二進位文件有輸入限制。

最大大小為 256 MiB。除了副檔名,也會驗證 MIME 與檔案簽章,因此格式與實際內容不一致的檔案無法開啟。

確認編輯內容後再儲存。

Markdown 需要明確執行儲存。預覽更新與寫入磁碟是兩件事,請在結束工作前儲存。

請用實際資料確認顯示結果。

複雜版面與圖表語法請使用實際檔案確認。如遇問題,可在應用程式內回報並附上重現條件。

先回答你可能關心的問題。

這是 Markdown 專用應用程式嗎?

不是。除 Markdown 外,也支援 HTML、PDF、Word(DOCX)、Excel(XLSX)和 PowerPoint(PPTX)。但各格式的編輯與檢視範圍不同。

支援哪些作業系統?

提供 macOS、Windows 和 Linux 版本。安裝前請確認發行檔案與目標環境。

它與 KatanA 系列函式庫有什麼不同?

KatanA 是可直接使用的桌面應用程式。系列函式庫是供開發者將文件模型、轉換和 UI 等元件整合到自己應用程式的組件。

KatanA / Desktop

下一次檢閱,用 KatanA。

用熟悉的文件,試試檔案樹、分頁和預覽帶來的閱讀方式。