思源笔记 专业块输入（九）

9.专业块输入

涵盖脑图、Mermaid、ECharts、流程图（flowchart.js / PlantUML）、五线谱（ABC记谱法）、Graphviz（Dot语言）以及媒体插入等高级功能。

一、脑图（思维导图）

  • 实现方式：基于 Markdown 无序列表（-）的缩进结构，而非图形化绘制。

  • 语法：

    • 使用减号 - 表示列表项。
    • 子节点相对于父节点缩进一个或多个空格。

  • 示例：

    - 中心主题
  - 分支1
    - 子分支1.1
  - 分支2

  • 特点：

    • 自动根据列表层级渲染为脑图布局。
    • 功能较为基础，无复杂布局/样式选项（可借助插件扩展）。

  • 适用场景：快速将大纲转为脑图，适合轻量级思维整理。

二、Mermaid 图表

Mermaid 是一种基于文本的图表工具，用简洁语法生成多种图表。

1. 基本语法结构

  • 第一行：图形类型（如 flowchart​、sequenceDiagram​、gantt​、classDiagram 等）
  • 可选第二行：布局方向（TB​ 从上到下、BT​ 从下到上、LR​ 从左到右、RL 从右到左）
  • 后续行：节点定义 和 连线关系

2. 节点形状语法

形状 语法
矩形（默认） ​节点ID[文字]
圆角矩形 ​节点ID(文字)
圆形 ​节点ID((文字))
菱形（判断） ​节点ID{文字}

3. 连线语法

  • ​--> ：带箭头的实线
  • ​--- ：无箭头的实线
  • ​-.-> ：带箭头的虚线
  • ​==> ：粗箭头
  • 可在连线上添加文字：--文字-->

4. 示例

flowchart TD
    A[开始] --> B{判断条件}
    B -->|是| C[处理]
    B -->|否| D[结束]

详细语法参考 mermaid.js.org

三、ECharts 图表

  • 简介：百度开源的数据可视化库，支持折线图、柱状图、散点图、K线图等。

  • 插入方式：输入 /​ → 选择 chart 块（本质是一个代码块，内容为 JSON 字符串）。

  • 注意：

    • ECharts 官方示例通常提供 JavaScript 代码，需转换为 JSON 格式才能在思源笔记中使用。
    • 新手可访问 ECharts 官方文档 查找示例代码并适配。

四、流程图（两种方式）

1. flowchart.js

  • 简介：特定领域语言，用于生成可缩放的流程图。

  • 语法三部分：节点定义、节点类型、节点连接。

  • 官方文档：flowchart.js.org

  • 示例：

    st=>start: 开始
op=>operation: 处理
cond=>condition: 判断?
e=>end: 结束

st->op->cond
cond(yes)->e
cond(no)->op

2. PlantUML

  • 简介：通过简单直观的语言生成时序图、类图、对象图、用例图等。

  • 输出格式：PNG、SVG 等。

  • 学习资源：PlantUML 官方文档（提供中文教程）。

  • 示例（时序图）：

    @startuml
用户 -> 系统: 登录请求
系统 --> 用户: 返回token
@enduml

两者均通过思源笔记的代码块或特定块插入，输入 / 搜索对应名称即可。

五、五线谱（ABC记谱法）

  • 适用人群：音乐专业学生、作曲爱好者。

  • 实现：思源笔记支持 ABC Music Notation（开源库 abcjs）。

  • 插入方式：输入 /​ → 选择 五线谱块。

  • 基本语法：

    • ​X: 乐谱序号
    • ​T: 曲名
    • ​M:​ 节拍（如 4/4）
    • ​Q: 速度
    • 音符：C D E F G A B（音高），配合数字/符号表示音长和变化音。

  • 示例：

    X:1
T:小星星
M:4/4
K:C
C C G G | A A G2 |

  • 学习：搜索“ABC记谱法教程”获取更多知识。也可将其他软件或网络上的 ABC 代码直接复制使用。

六、Graphviz（Dot 语言）

  • 简介：开源图形可视化软件，用于生物信息学、软件工程、数据库、机器学习等领域的结构化图形绘制。

  • 语言：Dot 语言，描述三种对象：图、节点、边。

  • 图类型：

    • 有向图（digraph）
    • 无向图（graph）

  • 布局引擎：

    • ​dot：层次布局（有向图）
    • ​neato：弹簧模型布局（无向图）
    • ​twopi：放射状布局
    • ​circo：环形布局
    • ​fdp：另一种弹簧模型

  • 示例（有向图）：

    digraph G {
  A -> B;
  B -> C;
  A -> C;
}

  • 使用建议：

    • 访问 graphviz.org 学习语法。
    • 官网提供 Gallery（画廊） 和 在线编辑器（Playground） ，可复制代码到思源笔记中修改。
    • 思源笔记中插入 Graphviz 块（输入 / 搜索）即可。

七、插入媒体

思源笔记支持插入图片、视频、音频以及 iframe 链接（嵌入外部网页）。

1. 插入在线视频

以 B站 / YouTube 为例

  • 方法：输入 /​ → 选择 插入 iframe 链接。

  • B站视频：

    • 直接复制浏览器地址栏的 URL（无需嵌入代码）。
    • 清晰度受 B站账号登录状态影响。

  • YouTube 视频：

    • 复制浏览器地址 URL 即可，限制较少。
    • 插入后可在思源笔记中拖动调整窗口大小。

2. 图片与音频

  • 直接拖拽或粘贴到编辑区即可（与第⑤集操作一致）。

八、小结

功能 核心技术/语法 适用场景
脑图 Markdown 无序列表 快速大纲转脑图
Mermaid 文本图表语言 流程图、时序图、甘特图等
ECharts JSON 格式图表 数据可视化（折线图、柱状图等）
flowchart.js 特定流程图语言 简单流程图
PlantUML 统一建模语言 时序图、类图等工程图
ABC记谱法 音乐记谱语言 五线谱乐谱
Graphviz (Dot) 图形描述语言 复杂网络、关系图、科学图形
插入媒体 iframe / 直接嵌入 在线视频、音频、外部网页

这些功能专业性较强，适合有特定需求的用户（程序员、数据分析师、音乐人、科研人员等）。初学者可按需选用，不必全部掌握。