ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

SiYuan代码块:200+语言语法高亮完全指南

2026/8/31 13:43:05 拓冰建站 浏览量
SiYuan代码块:200+语言语法高亮完全指南 SiYuan代码块200语言语法高亮完全指南【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan写技术笔记时粘贴一大段代码总是变成一片纯文本墙关键字看不清、逻辑读不动。SiYuan 的代码块功能基于 Highlight.js支持 200 语言的语法高亮再配合行号、换行、连字设置能让代码一眼看清结构。 看清代码块能干什么插入代码块后自动识别语言并着色覆盖主流到小众语言语言名、复制、更多选项换行/行号/连字都收在代码块工具栏里每个代码块可单独覆盖全局设置不影响其他块导出 HTML、Markdown 时高亮和设置一并带过去 插入第一个高亮代码块从新建笔记到看到高亮最短路径如下打开任意一篇笔记光标放到新行通过工具栏选择代码块或输入 触发得到空代码块点击左上角的语言名称选一个语言如js粘贴你的代码此时高亮立即生效工具栏的复制和更多选项同步可用。写入的内容大致长这样function fib(n) { return n 1 ? n : fib(n - 1) fib(n - 2); }渲染逻辑集中在 app/src/protyle/render/highlightRender.ts先取语言名语言未注册就回退plaintext再按设置决定换行、连字、行号。⚙️ 调整代码块显示配置核心开关都在设置页的编辑器分组配置定义见 app/src/config/tabs/editorTab.ts配置项作用默认值在哪里改editor.codeLineWrap长代码自动换行开设置 → 编辑器editor.codeSyntaxHighlightLineNum语法高亮行号开设置 → 编辑器editor.codeLigatures启用字体连字-显示为箭头开设置 → 编辑器代码块更多菜单对单个块覆盖以上任意一项跟随全局代码块工具栏改完保存即可当前页会重新渲染——看长行是否折行、行号列是否出现生效与否一目了然。 用三种语言演示高亮效果JavaScript 先看递归。开启连字后比较运算符和箭头会合成更紧凑的符号扫读更快。function calculateFactorial(n) { if (n 1) return 1; return n * calculateFactorial(n - 1); }换成 Python高亮带来的不只是颜色而是函数、字符串、控制流的边界都清晰了。def fibonacci(n): 生成斐波那契数列 a, b 0, 1 for _ in range(n): yield a a, b b, a b for num in fibonacci(10): print(num, end )再往上走一点Go 的并发代码里关键字、包名、字符串、通道操作的着色区分让数据流向很好辨认。package main import ( fmt time ) func main() { ch : make(chan string) go func() { time.Sleep(2 * time.Second) ch - Hello from goroutine! }() msg : -ch fmt.Println(msg) } 排查高亮失效的常见情况代码块整段纯文本无颜色 → 语言名没对上 hljs 注册的标识符被回退为 plaintext → 把语言名改成标准名如typescript、bash开了字体连字却看不出变化 → 当前字体本身不含连字字形 → 换成 JetBrains Mono 等支持连字的字体行号在长行换行后错位 → 行号列在渲染时按实测行高逐行生成渲染后再动 CSS 不会重算 → 从设置改字体大小或切换一次行号开关强制重渲染相关测量逻辑见 app/src/protyle/gutter/index.ts单个块想关掉行号但全局必须开 → 用代码块更多菜单对该块单独置为关其余块仍跟随全局代码块是 SiYuan 里性价比最高的一块阅读体验配好换行和连字后基本不用回头再调。想深入编辑器行为可以看官方指南目录 app/guide/20210808180117-czj9bvb/ 和内核的 Markdown 渲染相关文档 docs/SY-FORMAT.zh-CN.md。【免费下载链接】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),仅供参考