{"id":25528805,"url":"https://github.com/lzhbhlrpython/markdown-note-system","last_synced_at":"2026-04-17T13:32:43.482Z","repository":{"id":277018485,"uuid":"931024017","full_name":"lzhbhlrPython/Markdown-Note-System","owner":"lzhbhlrPython","description":"Markdown Note System 是一个基于 Flask 框架构建的轻量级笔记管理系统。系统主要采用 Markdown 作为笔记书写格式，实现对笔记的创建、编辑、预览、自动备份等功能，同时提供图片上传和管理功能。系统以文件系统和 JSON 文件为数据存储方式，不依赖传统数据库，追求简单、灵活和高效的设计理念。","archived":false,"fork":false,"pushed_at":"2025-02-11T17:26:03.000Z","size":39,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-11T18:24:01.089Z","etag":null,"topics":["markdown","note-taking","notes-app"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lzhbhlrPython.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-11T15:46:16.000Z","updated_at":"2025-02-11T17:26:06.000Z","dependencies_parsed_at":"2025-02-11T18:34:51.144Z","dependency_job_id":null,"html_url":"https://github.com/lzhbhlrPython/Markdown-Note-System","commit_stats":null,"previous_names":["lzhbhlrpython/markdown-note-system"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lzhbhlrPython%2FMarkdown-Note-System","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lzhbhlrPython%2FMarkdown-Note-System/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lzhbhlrPython%2FMarkdown-Note-System/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lzhbhlrPython%2FMarkdown-Note-System/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lzhbhlrPython","download_url":"https://codeload.github.com/lzhbhlrPython/Markdown-Note-System/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239749347,"owners_count":19690428,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["markdown","note-taking","notes-app"],"created_at":"2025-02-19T23:23:17.919Z","updated_at":"2025-10-18T09:47:29.196Z","avatar_url":"https://github.com/lzhbhlrPython.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Markdown Note System\n\nMarkdown Note System 是一个基于 Flask 框架构建的轻量级个人笔记管理系统。系统主要采用 Markdown 作为笔记书写格式，实现对笔记的创建、编辑、预览、自动备份等功能，同时提供图片上传和管理功能。系统以文件系统和 JSON 文件为数据存储方式，不依赖传统数据库，追求简单、灵活和高效的设计理念。\n\n## 功能特性\n\n- **项目管理**：支持创建、删除、导入和导出项目。\n- **笔记管理**：支持创建、编辑、删除、移动和验证笔记。\n- **图片管理**：支持图片上传、删除和图库展示。\n- **自动备份**：前端使用 localStorage 自动备份编辑中的笔记，减少意外丢失。\n- **数据完整性校验**：通过 SHA256 为笔记生成哈希，在保存笔记时进行校验，防止数据被篡改。\n\n## 安装与运行\n\n### 环境要求\n\n- Python 3.7+\n- Flask\n- 其他依赖项见 `requirements.txt`\n\n### 安装步骤\n\n1. 克隆项目代码：\n    ```sh\n    git clone git@github.com:lzhbhlrPython/Markdown-Note-System.git\n    cd markdown-note-system\n    ```\n\n2. 创建并激活虚拟环境：\n    ```sh\n    python3 -m venv venv\n    source venv/bin/activate  # 对于 Windows 系统，使用 `venv\\Scripts\\activate`\n    ```\n\n3. 安装依赖项：\n    ```sh\n    pip install -r requirements.txt\n    ```\n\n4. 运行 Flask 应用（默认端口8000）：\n    ```sh\n    python app.py port 5000\n    ```\n   或运行 GUI：\n    ```sh\n    python GUI.py\n    ```\n\n\n## 使用说明\n\n### 项目管理\n\n- **创建项目**：在首页输入项目名称并点击“创建项目”按钮。\n- **删除项目**：在项目卡片上点击“删除”按钮。\n- **导入项目**：在首页选择项目压缩包文件并点击“导入项目”按钮。\n- **下载项目**：在项目详情页点击“下载项目”按钮。\n\n### 笔记管理\n\n- **创建笔记**：在项目详情页输入笔记标题并点击“创建笔记”按钮。\n- **编辑笔记**：点击笔记卡片进入编辑页面，使用 Markdown 语法编辑内容。\n- **删除笔记**：在笔记卡片上点击“删除”按钮。\n- **移动笔记**：在笔记卡片上点击“移动”按钮并输入目标项目 ID。\n- **验证笔记**：在编辑页面点击“检测是否篡改”按钮。\n\n### 图片管理\n\n- **上传图片**：在图库页面选择图片文件并点击“上传图片”按钮。\n- **删除图片**：在图片卡片上点击“删除”按钮。\n- **复制链接**：在图片卡片上点击“复制链接”按钮。\n\n## 目录结构\n\n```plaintext\nmarkdown-note-system/\n├── app.py                            # Flask 应用主文件\n├── GUI.py                            # GUI 主文件\n├── requirements.txt                  # 依赖项文件\n├── templates/                        # HTML 模板文件\n│   ├── base.html\n│   ├── index.html\n│   ├── project_detail.html\n│   ├── note_edit.html\n│   ├── note_preview.html\n│   └── gallery.html\n├── static/                           # 静态文件目录\n│   └── uploads/                      # 图片上传目录\n├── data/                             # 数据存储目录\n│   ├── images.json                   # 图片数据文件\n│   └── \u003cproject_id\u003e/                 # 项目目录\n│       ├── metadata.json             # 项目元数据文件\n│       └── \u003cnote_id\u003e.md              # 笔记文件\n├── README.md                         # 项目说明文件\n├── LICENSE                           # 许可证文件\n└── Markdown Note System Document.zip # 文档(请导入系统查看)\n```\n\n## 贡献指南\n\n欢迎贡献代码！请遵循以下步骤：\n\n1. Fork 本仓库。\n2. 创建一个新的分支 (`git checkout -b feature-branch`)。\n3. 提交你的修改 (`git commit -am 'Add new feature'`)。\n4. 推送到分支 (`git push origin feature-branch`)。\n5. 创建一个 Pull Request。\n\n## 许可证\n\n该项目使用 MIT 许可证。详情请参阅 `LICENSE` 文件。\n\n## 联系方式\n\n如有任何问题或建议，请联系 [lzhbhlrpython](https://pyliubaolin.top/)。\n\n\n## 待完成\n1. 添加更多功能，如搜索、标签、分类等。\n2. 夜间模式。\n\n## 贡献列表\n1. [lzhbhlrPython](https://github.com/lzhbhlrPython)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flzhbhlrpython%2Fmarkdown-note-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flzhbhlrpython%2Fmarkdown-note-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flzhbhlrpython%2Fmarkdown-note-system/lists"}