尧图网站设计 尧图网站设计YAOTU DESIGN
ARTICLE DETAIL

资讯详情

深耕网站设计与一线实操的经验洞察。

SiYuan Mermaid 画电路图一次讲清:7 行文字画出第一张原理图

SiYuan Mermaid 画电路图一次讲清:7 行文字画出第一张原理图 SiYuan Mermaid 画电路图一次讲清7 行文字画出第一张原理图【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuanSiYuan思源笔记是一款开源、隐私优先的自托管知识工作空间编辑器内置 Mermaid 渲染在正文里敲几行文本就能当场画出一张可缩放、可导出的电路逻辑图。不用装插件、不用会编程图稿跟着笔记一起同步误删了还能靠数据历史找回来。和正文里的其他内容块一样这张图同样支持引用与反链改一次、处处生效。用文本代替截图为什么电路图适合交给 Mermaid技术笔记里最烦的事之一是电路用文字写了一大段读者却想象不出长相。拿画板工具画一张图再截图贴进文档每次改参数都得重画、重截、重贴截图放大还发虚也无法被搜索和引用。Mermaid 的思路完全不同图稿就是纯文本。每个元件是一个节点每根导线是一行A -- B。改个标号只需动一行文字图立刻跟着变。文本天然可以版本化、可以回溯误删后能通过 SiYuan 的数据历史恢复。渲染由内核保障。SiYuan 内置 Mermaid 11.x 渲染引擎默认开启时序图序号、自适应宽度深色模式下图表配色自动切换渲染实现见 app/src/protyle/render/mermaidRender.ts。输出是 SVG 矢量图放大不糊放进文档或演示都够用。图稿融入知识库。它和其他内容块一样能被引用、反链、搜索。比如给「电源模块图」建一条引用之后写故障分析时直接嵌入原图元件改动一次、处处生效。用斜杠菜单或三个反斜杠插入代码块在空白行输入/弹出命令菜单输入mermaid找到「Mermaid」项后回车也可以手敲三个反斜杠加mermaid再回车结果一样。菜单选项的加载逻辑在 app/src/protyle/hint/extend.ts 中Mermaid 一项的过滤词里还包含「图表 / tubiao / tb」所以输中文也能命中。7 行代码画出第一张串联电路进入代码块后只需写下保存后或停手一拍页面立即渲染出「电源 → 电阻 → 灯泡 → 电源」的串联回路。背后的规律不复杂元件对应节点导线对应箭头整张图的方向由第一行graph声明。两个马上能用的小语法给连线加标注写成A --|220V AC| B竖线里写电压、电流方向或线号是电路图里信息量最大的一处。给元件上色先用classDef power fill:#f90,stroke:#333定义样式再在节点上追加:::power电源和检测元件就能一眼区分开。这里先提一个高频坑Mermaid 对语法错误非常直接——错一处整块图不渲染只显示红色错误信息。最常见的三个原因缩进里混了全角空格、节点 id 用了中文或特殊字符、漏写方括号。看到不渲染时先按错误提示定位到具体行再改别盲目删改。用 subgraph 给多模块电路分块真实电路通常由电源、控制、检测等模块组成。用subgraph给每个模块画一个边框模块内部先连内部节点跨模块的线统一放在最后。以「整流稳压电源 MCU 控制 传感检测」为例三个subgraph把图切成三块跨模块的供电线E -- F、E -- I留在结尾统一出现阅读顺序变成「先看模块内、再看模块间」。这套「先分模块、后补连线」的思路适用于任何多模块电路先想清楚有哪几个功能模块再数模块之间有几根线。两张建议让图保持可读单张图节点控制在 15 个以内一张图只讲一个主题仍然太挤时把graph LR和graph TB换一种试试布局差异很大或者拆成多张子图在笔记里用内容块引用把几张图串起来。图不渲染、挤成一团、算不算真原理图这是「真」电路图吗坦白说它画的是逻辑结构图模块框、信号流向、连接关系清楚适合方案记录、故障分析和教学精确的工程原理图电阻符号、引脚标注、网表仍交给专业 EDA 工具。两者定位不同并不冲突。图会被锁在 SiYuan 里吗不会。Mermaid 源码是纯文本拷到任何支持 Mermaid 的工具里都能直接渲染。图改错了怎么办编辑态是文字与图形双视图随时回看源码历史版本也能通过数据历史找回。画好的图怎么带走三条出路选中渲染结果复制图像直接粘贴进即时通讯或文档右键 → Export或顶部菜单把整篇笔记导出为 HTML / PDF图表以矢量形式保留导出实现见 app/src/protyle/export/index.ts直接复制 Mermaid 文本交给团队成员或别的 Mermaid 工具复用。参考资料官方文档README.zh-CN.md渲染实现app/src/protyle/render/mermaidRender.tsMermaid 流程图语法mermaid.js.org 的 flowchart 章节【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表