跳到主要内容

📝 Obsidian同步EMLOG插件

一个强大的 Obsidian 插件,让你能够轻松将笔记发布到 EMLOG 博客系统。(需要先安装 obsidian)

作者

功能特性

  • 🚀 一键发布 - 在 Obsidian 中直接发布笔记到 EMLOG 博客
  • 📝 智能更新 - 自动检测已发布的文章,支持增量更新
  • 🖼️ 图片上传 - 自动上传本地图片并替换为网络链接
  • 📋 微语发布 - 快速发布短文本内容
  • 🏷️ 分类标签 - 支持分类、标签、摘要等元数据
  • 🔐 多种认证 - 支持签名、API Key、Cookie 三种认证方式
  • 📱 草稿模式 - 支持草稿发布和正式发布
  • 🎨 自定义封面 - 支持设置文章封面图片
  • 🔧 灵活配置 - 丰富的设置选项和发布后动作

安装

方法一:手动安装(推荐)

  1. 下载最新版本的发布包 ,点击下载
  2. 解压到你的 Obsidian 库目录(在 Obsidian 设置 → 第三方插件 → 点击打开插件文件夹图标):.obsidian/plugins/obsidian-emlog/
  3. 在 Obsidian 中启用插件:设置 → 第三方插件 → 启用 obsidian-emlog

方法二:从源码构建

git clone https://github.com/qimuai/obsidian-emlog.git
cd obsidian-emlog
npm install
npm run build

配置

基本设置

  1. 打开插件设置页面
  2. 配置以下必要信息:

必需配置

  • 站点地址: 你的 EMLOG 博客地址(如:https://yourdomain.com
  • 鉴权方式: 选择认证方式
  • API Key: 根据鉴权方式填写相应的密钥

可选配置

  • 默认作者 UID: 文章作者ID
  • 默认分类: 文章默认分类
  • 默认发布为草稿: 是否默认以草稿形式发布
  • 自动封面: 是否自动提取首图作为封面
  • 允许评论: 是否允许文章评论
  • 发布后动作: 发布成功后的操作(打开浏览器、复制链接等)

认证方式说明

方式说明适用场景
签名使用时间戳和MD5签名生产环境(推荐)
API Key直接使用API密钥开发测试
Cookie使用登录Cookie临时使用

使用方法

发布文章

  1. 打开要发布的 Markdown 文件
  2. 使用命令面板
    • 发布当前笔记到 EMLOG - 正式发布
    • 发布为草稿到 EMLOG - 草稿发布
    • 自定义发布… - 自定义发布选项
  3. 或使用右键菜单
    • 在文件浏览器中右键点击 Markdown 文件
    • 选择相应的发布选项

发布微语

  1. 选中要发布的文本
  2. 执行命令发布微语(当前选中文本或提示输入)

图片处理

插件会自动处理文章中的图片:

  • 扫描本地图片文件
  • 自动上传到 EMLOG 服务器
  • 替换文章中的图片链接为网络地址

Frontmatter 支持

在 Markdown 文件头部可以设置元数据:

---
title: 自定义标题
tags: [obsidian, emlog]
excerpt: 自定义摘要
cover: https://example.com/cover.png
sort_id: 5
draft: y
author_uid: 1
post_date: "2025-01-02 12:00:00"
---