数据结构与安全
了解 Notedown 如何组织您的数据。我们采用透明、标准的文件格式，确保您的知识资产始终可控、可迁移。
1. 本地存储
Notedown 使用 chrome.storage.local 作为本地主数据库。这种方式保证了即便在断网环境下，您依然可以顺畅地阅读和搜索已收藏的内容。
2. Git 仓库文件布局
当您启用云端同步时，笔记将按照以下结构推送到 Git 仓库：
notedown/
├── notes/
├── 230915-a1b2.md # 笔记主文件
└── 230916-c3d4.md
└── assets/
└── 230915-a1b2/ # 对应笔记的资源文件夹
└── a7b8c9d0.png # 资源文件（内容哈希命名）
3. 笔记文件格式
每篇笔记都是一个标准的 Markdown 文件（或 HTML，取决于提取类型），顶部包含 YAML Front Matter 格式的元数据：
---
id: "230915-a1b2"
title: "如何使用 Git 作为后端"
url: "https://example.com/article"
tags: ["Git", "Serverless"]
folder: "技术文档"
createdAt: "2023-09-15T10:00:00Z"
updatedAt: "2023-09-15T10:30:00Z"
deleted: false
---
# 正文内容...4. 安全与权限建议
最小权限原则
在生成 Git Token 时，请务必只勾选 repo 或 repository_write 权限。不要给全局权限。
私有仓库
为了保护您的隐私，我们强烈建议创建一个私有项目来存储 Notedown 的笔记数据。
5. 基于 Webhook 的自动化
借助 Git 平台的 Webhook 能力，您可以构建丰富的后续链路：
- 全静态展示：通过 GitHub Pages 或 Vercel，将仓库直接转化为展示型博客。
- 搜索引擎接入：当仓库更新时，触发 Algolia 或 Meilisearch 的爬虫进行重索引。
- 多端分发：自动同步到您的语雀、Notion 或企业内部维基。