Code Block Plus

中文 | English

English

An enhanced code block plugin for Obsidian.

Adds a sleek header bar to every code block with a language pill (click to pick / search / type custom), a copy button, and consistent styling across editing and reading modes.

Features

• Language pill — Click the language label to open a searchable picker with 40+ preset languages. Type a custom language and it's auto-saved for next time.
• Hover copy button — Click to copy code content. Controls appear on hover and hide when the cursor leaves (toggleable in settings).
• Smart Ctrl/Cmd+A — First press selects the current code block body; second press selects all.
• Chinese punctuation trigger — Type ··· or ···python then press Enter to create a code block fence.
• Backspace deletes empty blocks — Press Backspace in an empty code block to remove the entire block.
• Collapsed fences — ``` fence lines are hidden; only the header bar and code content are visible.
• Auto empty line — New code blocks automatically get a blank body line so you can always press Backspace to delete.
• Customizable appearance — Optional custom background, border radius, and padding via settings.
• Bilingual UI — Switch between Chinese and English in settings.
• Mobile compatible — Touch-optimized controls, always visible on mobile devices.

Installation

From GitHub (manual)

1. Download main.js, styles.css, and manifest.json from the latest release.
2. Create a folder named siyuan-code-blocks inside your vault's .obsidian/plugins/ directory.
3. Copy the three files into that folder.
4. Enable the plugin in Obsidian → Settings → Community plugins.

From Obsidian Community Plugins (coming soon)

Search for "Code Block Plus" in Obsidian's community plugin browser.

Settings

Compatibility

• Obsidian v1.4.0+
• Desktop & mobile

中文说明

一款为 Obsidian 带来增强代码块体验的插件。

为每个代码块添加精致的头部栏，包含语言标签（点击可选择 / 搜索 / 自定义输入）和复制按钮，编辑模式与阅读模式样式一致。

功能特性

• 语言标签 — 点击语言标签打开可搜索的选择器，内置 40+ 预设语言。输入自定义语言会自动保存，下次可直接选用。
• 悬停复制按钮 — 点击复制代码内容。控件悬停时显示，移开后隐藏（可在设置中关闭）。
• 智能 Ctrl/Cmd+A — 第一次按下选中当前代码块内容，第二次按下全选。
• 中文标点触发 — 输入 ··· 或 ···python 后按回车，自动创建代码块围栏。
• Backspace 删除空代码块 — 在空代码块中按 Backspace 可删除整个代码块。
• 围栏折叠 — 自动隐藏 ``` 围栏行，只显示头部栏和代码内容。
• 自动空行 — 新建代码块自动插入空行，方便按 Backspace 删除。
• 外观自定义 — 可选自定义背景色、圆角和内边距。
• 双语界面 — 在设置中切换中文/英文。
• 移动端兼容 — 触控优化，控件在移动端始终可见。

安装

从 GitHub 手动安装

1. 从 最新发布 下载 main.js、styles.css 和 manifest.json。
2. 在你的仓库 .obsidian/plugins/ 目录下创建 siyuan-code-blocks 文件夹。
3. 将三个文件复制到该文件夹中。
4. 在 Obsidian → 设置 → 第三方插件 中启用本插件。

从 Obsidian 社区插件市场安装（即将上架）

在 Obsidian 社区插件浏览器中搜索 "Code Block Plus"。

设置项

兼容性

• Obsidian v1.4.0+
• 桌面端 & 移动端

License

MIT