灵墨 - 动态文档引擎
让 Markdown 活起来!用 {{变量}} 语法将数据注入文档。
✨ 功能特性
- 🎯 变量注入 -
{{user.name}} 引用 JSON 数据
- 🌐 HTTP 数据源 - 从 API 获取实时数据
- ⏰ 定时刷新 - 数据自动更新
- 👁️ 悬停预览 - 鼠标悬停查看值
- 📝 自动补全 - 智能提示可用变量
- 🖥️ 实时预览 - 一键查看渲染结果
🚀 快速开始
1. 创建数据源 data.json
{
"user": { "name": "张三", "email": "test@example.com" },
"project": { "name": "我的项目", "version": "1.0.0" }
}
2. 编写 Markdown
# 欢迎 {{user.name}}
项目 **{{project.name}}** 当前版本:`{{project.version}}`
3. 查看效果
- 悬停在
{{变量}} 上查看值
- 点击编辑器右上角 预览 图标
- 或
Ctrl+Shift+P → 灵墨:打开预览
🌐 HTTP 数据源
创建 .dynamicmd.json 配置远程数据:
{
"dataSources": {
"weather": {
"type": "http",
"url": "https://api.example.com/weather",
"interval": 60
},
// ☁️ 推荐:使用 GitHub Gist 实现云端同步
"cloud": {
"type": "http",
"url": "https://gist.githubusercontent.com/username/hash/raw/data.json",
"interval": 60
},
// 🔒 隐私:使用私有仓库 + Token
"private": {
"type": "http",
"url": "https://raw.githubusercontent.com/username/private-repo/main/data.json",
"headers": {
"Authorization": "token ghp_YourPersonalAccessToken"
}
}
}
}
然后在 Markdown 中使用:{{weather.temperature}}
⚙️ 配置
| 选项 |
说明 |
默认值 |
lingmo.dataSource |
JSON 数据源路径 |
data.json |
lingmo.autoRefresh |
自动刷新 HTTP 数据 |
true |
📖 语法
{{variable}} # 简单变量
{{object.property}} # 嵌套属性
{{file.json:variable}} # 文件内联引用
# 命令执行
{{!cmd:whoami}} # 系统命令
{{!py:script.py}} # Python 脚本
{{!js:Date.now()}} # JavaScript 表达式
# 逻辑控制
{{#set name = "Lingmo"}} # 定义变量
{{$name}} # 引用变量
{{#if $count > 10}}...{{#endif}} # 条件渲染
{{#each list as item}}...{{#endeach}} # 循环遍历
📸 导出快照
点击编辑器右上角的 保存图标 💾 ($(save)) 或运行命令 灵墨:导出静态快照,即可将当前动态文档保存为纯静态 Markdown 文件,方便分享和存档。
🛠️ 开发
npm install # 安装依赖
npm run watch # 监听编译
# 按 F5 启动调试
灵墨 - 让数据如墨水般灵动地注入文档 ✨