本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：

- 我的帖子已经打上 开源推广 标签： 是

- 我的开源项目完整开源，无未开源部分： 是

- 我的开源项目已链接认可 LINUX DO 社区： 是

- 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是

- 以上选择我承诺是永久有效的，接受社区和佬友监督： 是

以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出

从 【开源推广】不是让 AI 替你读论文，而是把论文一点点织进知识库：作为一名在读物理博士，我现在怎么用 Obsidian + Notemd 做论文深读与长期积累 - 开发调优 - LINUX DO

继续

Important

全文上万字符长时间手打 + 十数张图，先前已经多次回复说明情况却都被认为是 ai 生成举报，上百楼内容丢失，哪怕为了其他佬友的认真讨论与交流的内容都请勿随意举报！如有意见请友好私信交涉)

注：这里有一个三分钟使用极简教程，正式使用前推荐看看：【全开源免费！抢先体验属于个人的Easy Research！Obsidian开发者手把手教你三分钟速通NotEMD！-哔哩哔哩】 https://b23.tv/lqR0RlA

L站禁止给群组引流，有需要进一步交流需要请给项目点star或私信本人进入。

安装

- Obsidian 社区插件里直接搜索 Notemd

- 或者去 GitHub 仓库查看源码和 release

项目地址：

- GitHub: notemd github项目

- Obsidian Community Plugin: 搜索 Notemd

下面是正文

Notemd 是一个开源的 Obsidian 社区插件，用来把论文阅读过程中的概念链接、概念笔记、原文证据摘录、背景补充、翻译、图表和工作流沉淀回知识库，并支持多语言 UI、README 和内容转换。

这篇只包含 1.9.2 到 1.9.4 里更新的部分：演示导出、Draw.io / Drawnix（优化中）、CircuitikZ、电路预览、设置搜索，还有 CLI等功能。

多说无益，先放几个一键导出的成品大家感受一下。（注：均由Deepseek-v4-flash生成）

导出源文件支持直接在drawio中打开

pptx与pdf一样，可直接播放，所有元素支持修改复制粘贴可自定义（pdf太大放不上来，放个ppt中的一页示例图）：

一篇 Markdown 导出成演示稿（我最喜欢的功能之一）

组会前最常见的情况是，笔记已经写完，但还没做 PPT 。标题、表格、Mermaid、代码块都得再搬一遍。现在可以在 Notemd 里把当前 Markdown 准备成 Slidev deck，再选择输出格式。

侧栏提供 HTML、PDF、PNG、PPTX 和 MP4。这些格式使用同一份准备好的 deck，改原笔记后可以重新导出。

第一次使用

1. 打开 设置 → Notemd → 演示导出，开启 启用演示导出。

2. 点击 检测环境。页面会显示 Node.js、Slidev(注意，这是我fork优化的版本，官方版本没有导出独立html这个功能)、Playwright Chromium、ffmpeg 是否可用。

3. 设置默认格式和 Vault 内的输出子文件夹。第一次建议选独立 HTML。

4. 打开要讲的笔记，在侧栏选格式，点击 一次性导出。

想先确认汇报结构时，可以打开 导出前先输出大纲。先生成大纲，自己改完后，再点击 基于大纲继续导出。大纲的 LLM 暂时不可用时，插件会使用确定性大纲继续流程。

输出 |
适用情况 |
说明 |

独立 HTML |
离线查看、发给同事 |
单文件，通常约 2-5 MB，可以直接打开。 |

服务器脚本 HTML |
希望文件更小 |
需要运行本地服务器脚本。 |

PDF |
打印、邮件、定稿 |
用于阅读。 |

PNG |
逐页审阅、发群、插文档 |
导出为图片序列。 |

PPTX |
还要在 PowerPoint / WPS 改文字 |
正文、代码和表格文字重点保留为可见原生文字；图形仍可能以 SVG 或其他几何对象落入文件。 |

MP4 |
自动播放、循环展示 |
需要 ffmpeg。 |

演示导出只支持桌面端，要求 Node.js 20+。PDF、PNG、PPTX 需要 Playwright，MP4 还需要 ffmpeg。PNG 和 MP4 的清晰度分为标准、高、超高；选得越高，导出越慢、文件越大。PPTX 会引用设置中选择的字体名，默认不嵌入字体，发给别人前要确认目标机器有这些字体。

原笔记的标题层级、表格宽度和图表尺寸会影响结果。页数多或含复杂表格时，导出后仍要实际翻一遍确认一下。

图表：先选类型，再选文件格式

图表功能现在有三个独立选择：

选择 |
例子 |

图表类型 |
流程图、时序图、数据图、电路图 |

生成格式 |
Mermaid、JSON Canvas、Draw.io、Drawnix（优化中）、CircuitikZ |

导出格式 |
SVG、PNG、PDF |

技术详解

Draw.io 和 Drawnix

Draw.io 输出为 .drawio，本质是 diagrams.net 的 mxfile XML。之后可以在 diagrams.net 或兼容工具中调整布局和连线。

Drawnix 输出为受支持子集的 .drawnix JSON，适合接入白板风格的编辑流程。

Obsidian 默认不会把 .drawio、.drawnix 和 .tex 渲染成图。保存时，Notemd 会在可用时附带 SVG companion 和 Markdown wrapper：wrapper 嵌入 SVG，并链接源文件。这样 Vault 里既有可看的预览，也有可再编辑的源。

电路图和 CircuitikZ

生成电路时，选择 电路图 和 CircuitikZ 源文件。插件先生成并校验 CircuitSpec，再写出受约束的 CircuitikZ .tex。

当前适合共源 NMOS 放大器和已支持的 CMOS 基础电路。器件库、模拟电路符号和复杂拓扑没有承诺全覆盖。请检查端口、连接、参数和信号方向，再将图放进技术材料。

无需安装完整 LaTeX，就可以在插件里预览，或导出 SVG、PNG、预览 PDF。这里的 SVG 是按已校验电路结构生成的审阅文件；并非 .tex 已被本机 LaTeX 或 TikZJax 编译成功。

需要编译诊断或原生 LaTeX PDF 时，在图形设置或命令面板打开 CircuitikZ 原生编译环境。它能识别系统中的 tectonic / pdflatex，也能配置自定义路径；确认后还可以安装托管 Tectonic。插件不会携带完整 TeX 发行版。

图形的 PNG/PDF 默认导出为 300 PPI，最大 600 PPI。SVG 是矢量文件，不受 PPI 影响。

图形历史

图形历史按 Vault 保存。预览窗口点 历史 后，右侧会出现搜索、筛选和分页；没有打开笔记时，也可以从命令面板或侧栏打开同一个历史视图。历史记录保存的是元数据和产物路径，删除记录不会删除生成的源文件或图片。

设置页可以搜索了

设置页顶部可以模糊搜索，常用项目可以收藏，收藏按 Vault 保存。第一次配置时可以直接搜：

- 演示导出：开启导出、设置目录、选择默认格式和检测环境。

- 首选生成格式：选择 Mermaid、Draw.io、Drawnix、CircuitikZ 等源格式的偏好。

- 图形预览导出 PPI：控制 PNG/PDF 的分辨率。

- CircuitikZ 原生编译环境：仅在需要原生编译或原生 PDF 时设置。

CLI：有三条路径

CLI 部分命令能被终端触发，但它们仍需要当前笔记、选区或预览窗口；这类命令适合桌面端操作，不适合直接拿去跑无人值守批任务。

导出设置等CLI

官方 Obsidian CLI

官方 CLI 可以列出和触发已注册的 Notemd 命令：```
obsidian commands filter=notemd
obsidian command id=notemd:export-cli-public-surface
```目前明确列为 public-safe 的命令只有四个：

- notemd:export-provider-profiles-redacted

- notemd:export-cli-capability-manifest

- notemd:export-cli-invocation-contract

- notemd:export-cli-public-surface

它们用于导出脱敏 Provider 配置、能力清单、调用契约和当前公开表面。脱敏文件仍可能带有私有网关的 base URL，分享前应检查。原始 Provider 配置可能包含凭据，不要公开。

仓库内维护 helper（核心功能集群，可以交给Agent调用）

仓库里有面向维护和调试的入口：```
npm run cli:help
npm run cli:invoke -- --vault <vault> --operation <operation-id> --input-json '<json>' --pretty
``现有 operation 包括**批量标题生成、章节拆分、研究总结、图表生成、本地知识库 inspect，以及 Provider/CLI 契约导出**。--vault 下的路径要写 Vault 相对路径。比如 --vault docs 时写 index.zh-CN.md，不要写 docs/index.zh-CN.md`。

这套 helper 依赖 Obsidian native eval，定位是维护工具。先用 obsidian help 检查官方 CLI；不要因为 npm 上出现同名包，就用它代替官方工具。

离线图表 artifact CLI

scripts/export-diagram-artifact.js 读取已校验的 DiagramSpec JSON，写出目标文件。它不启动 Obsidian，也不需要安装 diagrams.net Desktop、Drawnix 或 Plait。

调用细节```

Draw.io 源和预览 companion

node scripts/export-diagram-artifact.js --input spec.json --target drawio --output figure.drawio --preview-svg-output figure.drawio.svg --preview-png-output figure.drawio.png --preview-pdf-output figure.drawio.pdf --ppi 300

Drawnix 源和预览 companion

node scripts/export-diagram-artifact.js --input spec.json --target drawnix --output figure.drawnix --preview-svg-output figure.drawnix.svg --preview-png-output figure.drawnix.png --preview-pdf-output figure.drawnix.pdf --ppi 300

CircuitikZ 源和预览 companion

node scripts/export-diagram-artifact.js --input circuit-spec.json --target circuitikz --output circuit.tex --preview-svg-output circuit.svg --preview-png-output circuit.png --preview-pdf-output circuit.pdf --ppi 300
``它还支持 editable-html-svg、svg、png、pdf`。SVG 和源文件由 TypeScript 直接导出；PNG、PDF 用 Playwright Chromium 从同一份 SVG 渲染。带 BOM 或不带 BOM 的 UTF-8 JSON 都可读入。

旧的 npm 入口仍可用：```
npm run diagram:export-artifact -- --input spec.json --target drawio --output figure.drawio

图、演示大纲和电路都要人工核对。CircuitikZ 目前有明确的适用范围。PPTX 对可见文字和表格文字做了处理，复杂 SVG 或 Mermaid 仍不会自动变成每个部分都能在 Office 里拆开的对象。演示导出依赖本地桌面环境，第一次使用先跑环境检测。

如果觉得喜欢有所收获，对你有帮助，就支持一下吧!

![图片](https://cdn3.ldstatic.com/optimized/4X/c/7/7/c77568f0653ef32bd16ed00fdd32197d8e618c5d_2_500x500.png)

credit.linux.do

LINUX DO Credit

Linux Do 社区lao1服务平台

`