如何将obsidian笔记内容同步到hexo博客上 | How to sync obsidian notes to hexo blog

概述

Hi，我是你们的老朋友Eli，最近我在整理我的obsidian上的笔记时，我想将我的笔记内容同步到我的hexo博客文件夹下面出现了问题，原因是在hexo的博客中，front-matter是文件开头YAML代码块，需要将obsidian文件增加对应的属性值（title、categories、index_img、comment等），这一点已经解决——采用obsidian中自带的模板插件就能解决。然而，如何将obsidian笔记内容同步到hexo博客上有很多种方案，我采用了一种较为简单的方式——做一个python批处理脚本文件。其优势如下：

跨平台好，由于只需要标准库，因此有Python解释器就能在Linux、Windows等操作系统上跑起来。
扩展性强，Python代码易维护，模块化程度高，好扩展。

原理

原理很简单，使用了Python的文件操作，将obsidian笔记文件复制一份到目标博客文件夹下。设计一个识别以title开头的内容的方法，循环调用这个方法来替换每一个文件，如果文件不存在，源文件直接复制到目标文件，文件存在则通过title中的内容判断两个文件是否一致，如果一致，执行覆盖原目标文件；如果不一致，跳过目标文件创建一个新目标文件。以下给出了详细代码以及注释。
创建一个名为Sync_ObToHex.py文件

import os  
import shutil  
import re  
  
# 配置路径  
# 对于re库来说，处理正则表达式时，r前缀表示原始字符串，避免转义字符的问题
source_dir = r"这里填写你写的笔记内容绝对路径"  
target_dir = r"这里填写你要同步的文件夹下的内容绝对路径"  
  
# 创建源文件夹（如果不存在）  
os.makedirs(source_dir, exist_ok=True)  
# 创建目标文件夹（如果不存在）  
os.makedirs(target_dir, exist_ok=True)  
  
def extract_title(file_path):  
    """从 Markdown 文件中提取 Front Matter 的 title"""    
    with open(file_path, 'r', encoding='utf-8') as f:  
        content = f.read()  
        # 匹配一行上以title开头的任意字符，  
        match = re.search(r'^title:\s*["\']?(.*?)["\']?\s*$', content, re.MULTILINE)    # ^ 和 $ 开头和结尾  
        # 正则表达式：“^title:”匹配以title开头的内容，“\s*”匹配任何空白字符，“["\']?”匹配一个可选的引号（单引号或双引号），“(.*?)”尽可能少的.*匹配任意字符（除了换行符），?使用非贪婪模式，“$”匹配行的结尾  
        # re.MULTILINE，正则表达式中^操作符能够将给定字符串的每行当做匹配开始  
        # re.search(pattern,string,flags = 0)  
        # 在一个字符串中搜索匹配正则表达式的第一个位置，返回match对象  
        # pattern:正则表达式的字符串或原生字符串表示  
        # string:待匹配字符串  
        # flags:正则表达式使用时的控制标记  
        return match.group(1).strip() if match else None  
        # match是一个re.match对象，group(1)表示提取第一个捕获组(.*?)的内容，即title的值  
        #strip()去除首尾的空白字符（空格、换行符、引号）  
  
  
for filename in os.listdir(source_dir):     # 遍历源目录中的所有文件  
    # 构建源文件和目标文件的完整路径（不会创建文件本身）  
    source_file = os.path.join(source_dir, filename)  
    target_file = os.path.join(target_dir, filename)  
  
    if not filename.endswith('.md'):  
        continue  # 跳过非Markdown文件  
  
    if os.path.exists(target_file):         # 检查目标目录中是否已存在同名文件  
        # 分别从源文件和目标文件中提取标题  
        source_title = extract_title(source_file)  
        target_title = extract_title(target_file)  
  
        if source_title == target_title:  
            print(f"[覆盖] 标题相同: {filename} (Title: {source_title})")  
            shutil.copy2(source_file, target_file)  # 将文件A复制到文件B，并保留复制内容，保留权限，保留时间戳  
        else:  
            print(f"[跳过] 标题不同: {filename} (源Title: {source_title}, 目标Title: {target_title})")  
    else:  
        print(f"[新增] {filename}")  
        shutil.copy2(source_file, target_file)  
  
print("同步完成！")  
input("按 Enter 退出...")