Skip to content

导出与分享

概述

Obsidian 支持多种导出格式,方便你分享笔记或在其他工具中使用。

导出为 PDF

单笔记导出

  1. 打开要导出的笔记
  2. 使用命令面板:Ctrl/Cmd + P
  3. 输入「导出为 PDF」
  4. 选择保存位置

PDF 设置

yaml
导出选项:
  - 页面大小: A4 / Letter
  - 方向: 纵向 / 横向
  - 页边距: 默认 / 自定义
  - 包含页码: 是 / 否
  - 包含标题: 是 / 否

批量导出 PDF

使用插件批量导出:

  • Batch Export to PDF:批量导出多个笔记
  • PDF Export:增强 PDF 导出功能

导出为 Markdown

单笔记导出

Markdown 是 Obsidian 的原生格式,直接复制即可:

  1. 右键点击笔记
  2. 选择「在资源管理器中显示」
  3. 直接复制 .md 文件

批量导出

复制整个仓库文件夹:

bash
# 复制到其他位置
cp -r /path/to/vault /backup/location

# 压缩备份
tar -czf obsidian-backup.tar.gz /path/to/vault

排除配置文件

导出时排除 .obsidian 文件夹:

bash
# 只导出笔记内容
rsync -av --exclude='.obsidian' --exclude='.trash' /path/to/vault/ /export/location/

导出为 HTML

使用插件导出

安装 Webpage HTML Export 插件:

  1. 打开设置 → 第三方插件
  2. 搜索「Webpage HTML Export」
  3. 安装并启用

导出步骤

  1. 打开要导出的笔记
  2. 使用命令面板选择导出命令
  3. 配置导出选项
  4. 选择保存位置

HTML 导出设置

设置项推荐值说明
包含样式自定义 CSS保留 Obsidian 外观
图片处理嵌入图片打包到 HTML
交互功能关闭纯静态导出
目录导航开启生成侧边目录

使用 Pandoc 导出

Pandoc 是强大的格式转换工具,支持更多导出格式:

安装 Pandoc:

bash
# macOS
brew install pandoc

# Windows
winget install pandoc

# Linux
sudo apt install pandoc

导出为 Word 文档:

bash
pandoc 笔记.md -o 笔记.docx

导出为 HTML(带样式):

bash
pandoc 笔记.md -o 笔记.html --standalone --metadata title="笔记标题"

批量导出:

bash
# 将所有 .md 文件导出为 docx
for f in *.md; do pandoc "$f" -o "${f%.md}.docx"; done

长文导出排版技巧

导出长文(如电子书、论文)时的优化:

  1. 目录生成:在 frontmatter 中添加 toc: true
  2. 分页设置:PDF 导出时设置页面大小和边距
  3. 图片处理:确保图片使用相对路径
  4. 代码块:设置代码高亮主题

导出为图片

截图导出

  1. 使用系统截图功能

    • WindowsWin + Shift + S
    • macOSCmd + Shift + 4
  2. 使用插件

    • Copy Block Link:复制代码块截图
    • Ozan Image Editor:图片编辑和导出

导出图谱

  1. 打开关系图谱
  2. 调整到满意状态
  3. 点击右上角「...」菜单
  4. 选择「导出为 PNG」

分享笔记

Obsidian Publish

官方发布服务,详见 发布功能

yaml
Publish 特点:
  - 一键发布
  - 自定义域名
  - 自动更新
  - SEO 优化

分享到社交平台

使用插件快速分享:

插件功能
Share to Notion分享到 Notion
Share to Ghost分享到 Ghost 博客
Share to WordPress分享到 WordPress

生成分享链接

使用第三方服务:

  • Bear Blog:轻量博客平台
  • Notion:发布为网页
  • GitHub Pages:静态网站托管

导出特定内容

导出标签内容

使用 Dataview 插件:

dataview
LIST
FROM #标签名

然后复制查询结果。

导出搜索结果

  1. 执行搜索
  2. 使用「复制搜索结果」命令
  3. 粘贴到新笔记

导出反向链接

使用插件导出链接关系:

  • Backlink Cache:导出反向链接数据
  • Graph Analysis:导出图谱数据

迁移到其他工具

迁移到 Notion

Obsidian 的 Markdown 格式与 Notion 兼容:

  1. 在 Notion 中创建新页面
  2. 导入 Markdown 文件
  3. 手动调整特殊格式

迁移到 Roam Research

转换语法差异:

markdown
# Obsidian
[[链接文本]]
#标签

# Roam Research
[[链接文本]]
#标签

大部分语法可以直接使用。

迁移到其他 Markdown 工具

Obsidian 使用的标准 Markdown 格式可直接用于:

  • Typora
  • VS Code
  • Mark Text
  • Joplin
  • Logseq

自动化导出

使用脚本

python
import os
import shutil

def export_notes(vault_path, output_path):
    # 排除配置目录
    exclude = ['.obsidian', '.trash', '.git']
    
    for item in os.listdir(vault_path):
        if item not in exclude:
            src = os.path.join(vault_path, item)
            dst = os.path.join(output_path, item)
            
            if os.path.isdir(src):
                shutil.copytree(src, dst)
            else:
                shutil.copy2(src, dst)
    
    print(f"导出完成: {output_path}")

export_notes('/path/to/vault', '/path/to/export')

使用 Git

定期提交到远程仓库:

bash
# 初始化 Git
cd /path/to/vault
git init

# 创建 .gitignore
echo ".obsidian/workspace.json" >> .gitignore

# 提交
git add .
git commit -m "Export notes"
git push origin main

使用 Obsidian Git 插件

自动备份到 Git:

  1. 安装 Obsidian Git 插件
  2. 配置自动提交间隔
  3. 设置远程仓库

导出模板

导出清单

创建导出前检查清单:

markdown
# 导出清单

## 准备
- [ ] 检查所有内部链接
- [ ] 验证图片引用
- [ ] 清理临时笔记
- [ ] 更新目录索引

## 导出
- [ ] 选择导出格式
- [ ] 配置导出选项
- [ ] 执行导出
- [ ] 验证导出结果

## 后续
- [ ] 测试导出文件
- [ ] 备份原始文件
- [ ] 记录导出日期

导出常见问题

格式丢失?

某些格式在其他工具中可能不支持:

  • 双向链接 [[链接]]
  • 高亮语法 ==高亮==
  • 内嵌文件 ![[文件]]

图片丢失?

确保图片一起导出:

  1. 使用相对路径引用图片
  2. 导出时包含图片文件夹
  3. 检查图片引用是否正确

中文乱码?

确保编码正确:

  1. 使用 UTF-8 编码
  2. 在导出设置中选择编码
  3. 使用支持 UTF-8 的打开工具

下一步