笔记
创建短内容笔记
笔记
笔记是 PrimeEdge 的轻量级内容类型,适合快速记录短内容、想法和片段。
特点
- 简洁快速: 无需复杂 Front Matter
- 轻量发布: 适合短内容、碎碎念
- 时间线展示: 按时间倒序排列
- 无目录: 页面更简洁
创建笔记
hugo new content notes/my-note.md
笔记 Front Matter
---
title: "笔记标题"
date: 2024-01-15T10:00:00+08:00
categories: ["技术笔记"]
tags: ["想法", "随笔"]
toc: false
---
笔记的 Front Matter 比文章更简洁:
| 字段 | 必填 | 说明 |
|---|---|---|
title | 是 | 笔记标题 |
date | 是 | 发布时间 |
categories | 否 | 分类(支持子分类目录) |
tags | 否 | 标签 |
toc | 否 | 是否显示目录,默认 false |
draft | 否 | 草稿状态 |
与文章的区别
| 特性 | 笔记 | 文章 |
|---|---|---|
| 长度 | 短内容 | 长文 |
| 目录 | 无 | 有 |
| 封面图 | 无 | 有 |
| 评论 | 可选 | 默认开启 |
| 摘要 | 全文 | 自动生成 |
| 布局 | 紧凑 | 完整 |
适用场景
- 日常想法记录
- 技术片段备忘
- 阅读摘抄
- 待办事项
- 灵感记录
- 生活随笔
笔记模板
创建 archetypes/notes.md:
---
title: "{{ replace .Name "-" " " | title }}"
date: {{ .Date }}
draft: false
tags: []
---
笔记列表页
笔记列表页自动按时间倒序展示所有笔记。
创建列表页
创建 content/notes/_index.md:
---
title: "笔记"
description: "随想随记,记录点滴"
---
笔记写作建议
- 保持简短: 笔记适合 500 字以内的内容
- 及时记录: 有想法立即记录,不要拖延
- 添加标签: 方便后续检索和分类
- 定期整理: 将成熟的笔记扩展为文章
示例笔记
---
title: "Hugo 常用命令备忘"
date: 2024-01-15T10:00:00+08:00
tags: ["hugo", "备忘"]
---
常用 Hugo 命令:
```bash
# 新建站点
hugo new site myblog
# 新建文章
hugo new content posts/hello.md
# 本地预览
hugo server -D
# 构建
hugo --minify
记得加上 -D 参数才能预览草稿。
## 笔记归档
笔记支持按分类子目录组织:
content/notes/
├── _index.md
├── 技术笔记/
│ ├── _index.md
│ └── note-1.md
├── 学习记录/
│ ├── _index.md
│ └── note-2.md
└── 随手记/
├── _index.md
└── note-3.md
每个子目录需要一个 `_index.md` 文件:
```yaml
---
title: "技术笔记"
---
后台管理
如果部署了 PrimeEdge Admin,可以在后台管理笔记:
- 表格列表展示(标题、日期、分类)
- 支持分类筛选和关键词搜索
- Markdown 编辑器 + 实时预览
- 可选择发布时间、分类、目录开关
详见 后台管理教程
从笔记到文章
当笔记内容逐渐丰富,可以扩展为正式文章:
- 复制笔记内容到
posts/目录 - 完善 Front Matter(添加 description、cover 等)
- 扩展内容,添加更多细节
- 添加目录结构
- 发布文章后,可以保留或删除原笔记
评论