【亲测免费】 Obsidian 更好代码块插件安装与使用指南

项目简介

Obsidian Better Codeblock 是一个专为 Obsidian 笔记应用设计的插件，旨在提升代码块的展示效果。它允许在预览模式下增强Markdown代码块，通过添加标题、行号以及可点击展开或折叠的代码块功能。此外，用户可以自定义代码块的高亮和默认折叠状态。

目录结构及介绍

仓库的目录结构组织如下：

.
├── main.js           # 主要逻辑实现文件
├── main.ts           # 类型脚本源码
├── manifest.json     # 插件元数据，描述插件信息和权限需求
├── styles.css        # 样式表，控制插件的视觉呈现
├── editorconfig      # 编辑器配置文件，确保代码风格一致
├── eslintignore      # ESLint 忽略文件列表
├── eslintrc          # ESLint 配置文件
├── gitattributes     # Git 属性配置文件
├── gitignore         # Git 忽略文件列表
├── npmrc             # NPM 配置文件
└── README.md         # 项目说明文件，包括安装和使用指引

• main.js: 运行时的主要JavaScript文件，包含了插件的核心逻辑。
• main.ts: TypeScript源代码，与main.js相对应，提供类型安全。
• manifest.json: 插件的配置文件，定义了插件名称、版本、作者等元数据，以及插件的入口点。
• styles.css: 定义插件所有CSS样式，用于美化代码块。
• 其余文件（.editorconfig, .git*, npmrc, etc.）主要用于开发者环境配置和代码质量保证。

项目的启动文件介绍

• 启动文件：实际上，对于用户而言，无需直接“启动”这个插件。它的激活是通过Obsidian内的插件管理界面进行安装后自动加载的。但技术上讲，核心逻辑的启动是从main.js或其TypeScript对应源文件main.ts开始执行的，这取决于开发和运行的阶段。

项目的配置文件介绍

• manifest.json 是本插件的关键配置文件，它包含以下重要字段：

  • name: 插件名称。
  • version: 版本号，标志着每次更新的状态。
  • author: 作者信息。
  • description: 插件的功能简述。
  • obsidianVersion: 兼容的Obsidian版本。
  • url: 插件的主页或GitHub地址。
  • bindings: 可选，用于指定任何用户交互绑定。

  用户不会直接编辑此文件以配置插件行为，但它是开发者调整插件元数据的地方。

要使用这个插件，用户不需要直接操作这些开发相关的文件。通常步骤包括从Obsidian的社区插件库中搜索并安装Obsidian Better Codeblock，随后便能在笔记中享受增强的代码块特性。如果手动安装，需将上述提到的相关文件放置到正确的Obsidian插件目录下，并重启Obsidian以使插件生效。