Opensophy Hub：用于 Markdown 文档的 SSG/SPA

Opensophy Hub：高级 Markdown 文档的静态 SSG/SPA 平台

Opensophy Hub 是一个混合 SSG 和 SPA 平台，专为发布技术文档、文章和手册而设计。它解决了在不使用 MDX 或额外插件的情况下存储具备高级 Markdown 功能的内容的难题。项目结构直接从 Docs/ 目录的文件系统中生成，其中文件夹定义导航：侧边栏、面包屑导航和 URL 均自动创建。

示例结构：

Docs/
├── welcome.md
├── [N][brain]Articles{article}/
│   ├── [C][folder-code]Development{development}/
│   │   └── [A][layers]Stack Selection{webrendering}.md
│   └── [C][signal]Tools{tools}/
│       └── [A][container]Dokploy Overview{dokploy}.md

三个层级的层次结构——部分（[N]）、类别（[C]）、文章（[A]）——无需手动路由设置即可提供 slugs、图标和标题。这简化了中高级开发者的内容维护和扩展。

无依赖的高级 Markdown

Hub 将丰富的块直接引入标准 .md 文件：警告框、卡片、列、步骤器、图表、KaTeX 公式，以及从表格生成的图表。它使用简单的语法结构，而不是带有类名的 HTML 标记。

HTML 中的警告框示例：

<div class="alert alert-warning" role="alert">
  <strong>Ostorozhno!</strong> Udalyonnye cherez <code>rm</code> files not popadayut in korzinu.
</div>

在 Hub 中：

:::caution
Files deleted with `rm` don't go to the trash.
:::

分步指导（步骤器）：

:::steps
:::step[status=done] Installation
`npm install`
:::
:::step[status=active] Setup
Fill out `.env`.
:::
:::step[status=pending] Launch
`npm run dev`
:::
:::

这些块无需外部库即可原生渲染，降低了构建复杂性，并在 SPA 模式下提升性能。

交互式表格和 UI 演示区

标准 Markdown 表格可转换为交互式组件，支持列过滤（多选）、带高亮的搜索、列隐藏、全屏、拖动滚动，以及导出为 Markdown/Excel。

它还支持一行代码嵌入实时 UI 库组件：

[uic:blur-text]

用户可以动态调整参数——缩放、颜色、动画、速度——并实时查看结果。非常适合在文档中演示组件，而无需单独的 playground。

编辑用的 CMS 面板

内置的内容管理面板允许您编辑 Markdown 并实时预览。在界面中直接创建页面、类别和部分——无需重启 npm run dev 或运行脚本。完整的块格式支持提供了类似完整 CMS 的工作流程，但由静态生成驱动。

开发者优势：

• 文件结构自动生成导航。
• 无需插件或 MDX 的高级 Markdown。
• 带过滤和导出的交互式表格。
• UI 组件的实时 playground。
• 带预览的 CMS 式编辑器。

核心亮点

• 文件结构即导航： 从前缀 [N]、[C]、[A] 完全自动化路由、面包屑和侧边栏。
• 原生 Markdown 块： 警告框、步骤器、列、KaTeX、图表——无依赖。
• 表格交互性： 过滤、搜索、全屏、导出为 MD/Excel。
• UI 演示区： 一行代码即可实时演示组件并调整参数。
• CMS 界面： 带预览的编辑，无需构建。

— Editorial Team