# 筆記與可攜 Markdown

> 讓編輯器好用，也讓 Markdown 仍然可以帶走。

## 編輯器把好用和可攜放在一起

Hyday 編輯器把所見即所得的便利性，和純 Markdown 檔案的穩定性放在一起。你在編輯器裡看到的是排版後的樣子，不需要一直面對 `**粗體**` 這些符號；筆記存到電腦後，仍然是可以帶走、用其他工具開啟的 Markdown 檔案。

## 可以使用哪些 Markdown 語法？

Hyday 可以處理常見的 Markdown 語法，也支援表格、待辦清單與刪除線等常用延伸功能：

- **文字與段落**：標題、粗體、斜體、刪除線、行內程式碼
- **清單與區塊**：項目清單、編號清單、待辦清單、引用、程式碼區塊與分隔線
- **內容元素**：表格、圖片、一般連結、註腳與數學公式
- **圖表與媒體**：Mermaid 圖表、影片與 YouTube 內容
- **提示區塊**：使用 `> [!NOTE]` 這類 Markdown 語法，把提醒或重點內容整理成提示區塊

需要插入內容時，可以在編輯器中輸入 `/`，從命令面板選擇標題、清單、引用、程式碼、公式、表格、圖片、影片或提示區塊。存檔後，這些內容仍會回到 Markdown 檔案裡。

## Front Matter 是你的資料

Front Matter 是放在 Markdown 檔案最上方、用來記錄筆記資料的一段 YAML。它是筆記的一部分，不是藏在 Hyday 裡的表單；你可以直接用文字編輯器打開檔案查看或修改。

```yaml
---
title: "我的年度規劃"
tags:
  - 工作
  - 2026計畫
---
```

- `title`：筆記標題
- `tags`：整篇筆記適用的標籤，也可以使用 `tags: [工作, 2026計畫]` 的寫法
- `type`：筆記類型。一般筆記可以先不填；擷取文章或建立卡片時，Hyday 會依內容寫入
- `createdAt`：建立時間，由 Hyday 建立
- `lastModified`：最後修改時間，由 Hyday 自動更新

Front Matter 必須放在檔案最前面，並用兩組 `---` 包住。建立一般筆記時，不需要先把所有欄位補齊；`createdAt` 和 `lastModified` 也不需要手動修改。

Hyday 不會為了建立索引，就自動替你寫的筆記補上標籤、ID 或 AI 摘要。這些內容如果沒有出現在你的 Markdown 檔案裡，就不會被偷偷加進去。

## 連結、標籤與人事物

Hyday 把這些功能保留成 Markdown 文字中的語法，因此內容不會被鎖在資料庫裡：

- `[[另一篇筆記]]`：連到資料夾裡的另一篇筆記。輸入 `[[` 後，可以搜尋並選取筆記；如果需要顯示別的文字，也可以寫成 `[[檔案名稱|顯示文字]]`。
- `#標籤`：在內文中替某段內容加上標籤。整篇筆記適用的標籤，也可以寫在 Front Matter 的 `tags` 裡。
- `@(人事物)`：標記具體的人、事件、地點或其他對象，方便之後查看相關紀錄。

這三種語法都還是原本的文字。Hyday 會在編輯器裡提供搜尋、連結與整理功能，但在其他工具中開啟時，是否能顯示相同的互動效果，取決於該工具支不支援這些寫法。

日誌裡還可以使用 LifeLog 標記，例如 `>(09:00)`、`<(09:50)`、`%(剛想到的事)` 和 `!(重要事項)`。這些標記也會以文字保留在 Markdown 檔案中，詳細用法可以參考[寫日誌與使用 LifeLog](/docs/journal-and-lifelog)。

## 帶到其他工具時會發生什麼事？

標準 Markdown 內容，例如標題、清單、表格、引用、程式碼、圖片與一般連結，都可以直接用其他 Markdown 工具開啟。Hyday 的延伸語法則會保留原始文字；其他工具即使不認得它們，也不會因此拿不到筆記內容，只是可能不會顯示相同的連結、標籤或提示區塊效果。

> **檔案核心永遠是純 Markdown。** 編輯器裡看到的排版與互動，最後都會回到可以閱讀、備份與帶走的文字檔案。

如果要開始寫筆記，可以回到[建立第一篇筆記](/docs/create-first-note)；如果手上已經有 Markdown 檔案，接著閱讀[匯入既有 Markdown 筆記](/docs/import-existing-notes)。