友野工坊 · 文章编辑器

817 字
4 分钟
友野工坊 · 文章编辑器
Chuc-Jie
/
tomono-editor
Waiting for api.github.com...
00K
0K
0K
Waiting...

一个功能完备的博客文章编辑器,为适配本博客的创作者设计。支持 Front-matter 元数据管理、实时预览、深色模式、本地草稿保存、导入导出等功能,开箱即用。

特性#

  • 📝 Markdown 实时编辑与预览:左侧编辑,右侧即时渲染,支持代码高亮
  • 🏷️ Front-matter 元数据管理:支持标题、日期、标签、分类、封面图片、草稿状态等常见字段
  • 🎨 深色模式:跟随系统偏好或手动切换,护眼舒适
  • 💾 本地草稿存储:一键保存草稿至浏览器本地存储,随时恢复
  • 📂 导入/导出:导入已有 .md 文件继续编辑,导出为带完整 Front-matter 的 Markdown 文件
  • 快捷插入:工具栏提供加粗、斜体、链接、图片、代码块快捷插入,提升写作效率
  • 🔍 完整预览:底部展示包含 YAML 元数据的完整 Markdown 源码,便于检查
  • 🌐 响应式设计:适配桌面端与移动端,界面简洁现代

快速开始#

  1. 克隆或下载本仓库中的 index.html 文件。
  2. 双击 index.html 文件,使用现代浏览器(Chrome、Firefox、Safari、Edge 等)打开。
  3. 开始书写你的博客内容!

使用方法#

基础操作#

  • 编辑元数据:左侧面板可设置标题、日期、标签、分类、封面图等。
  • 撰写正文:右侧编辑器支持标准 Markdown 语法。
  • 实时预览:正文右侧会即时渲染效果,代码块会自动高亮。
  • 导入文章:点击顶部“导入”按钮,选择本地 .md 文件(文件内可包含 Front-matter,格式为 YAML)。
  • 导出文章:点击“导出”按钮,将自动生成以 日期-标题 命名的 .md 文件。
  • 存草稿/恢复:使用底部工具栏的“存草稿”和“恢复”按钮管理本地草稿。

高级特性#

  • 标签管理:在“基础信息”区域,标签输入框支持以空格分隔的输入方式,自动转换为 YAML 数组。
  • 日期格式:发布日期和更新日期会以 YYYY-MM-DD 格式无引号输出,符合多数静态站点生成器的规范。
  • 自定义 Slug:在“高级设置”中可指定文章的 URL 别名。
  • 密码保护:可设置文章访问密码及提示,前端仅作展示,实际鉴权需后端配合。

技术栈#

  • 前端框架:Vue 3 (CDN)
  • 样式:Tailwind CSS + 自定义毛玻璃效果
  • Markdown 解析:Marked.js
  • 代码高亮:Highlight.js
  • YAML 处理:js-yaml
  • 图标:FontAwesome 6

项目结构#

├── index.html # 单文件应用,包含所有 HTML/CSS/JS
└── README.md # 项目说明文档

自定义与扩展#

你可以自由修改 index.html 中的样式、添加新的 Front-matter 字段或调整编辑器功能。所有代码均为原生实现,无需构建工具。

注意事项#

  • 文章密码功能仅在前端记录,实际应用中需结合后端进行验证。
  • 导出时,文件名中的特殊字符(如 /: 等)会被自动替换为 -
  • 深色模式会保存至 localStorage,下次打开时自动应用。

贡献#

欢迎提交 Issue 或 Pull Request!如有改进建议,请通过 GitHub 项目页反馈。

许可证#

MIT License © 2025 Chuc-Jie

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或赞助支持!

赞助
友野工坊 · 文章编辑器
https://blog.youyer.top/posts/tomono-editor/
作者
友野
发布于
2026-03-21
许可协议
CC BY-NC-SA 4.0
Profile Image of the Author
友野
从涓流到江河,从爝火到燎野。记录种种痕迹,无论它来自晨露还是野火。
公告
欢迎来到我的博客!这是一则示例公告。
音乐
封面

音乐

暂未播放

0:00 0:00
暂无歌词
分类
标签
站点统计
文章
22
分类
9
标签
47
总字数
24,445
运行时长
0
最后活动
0 天前

目录