Skip to content

Docs/issue 373 ecosystem showcase #406

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Saviour5538 wants to merge 2 commits into
base: main
Choose a base branch
from
+16 −1
Open

Docs/issue 373 ecosystem showcase #406

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2d2cd1a
docs(spec): clarify that leading-slash paths are relative to bundle r…
Saviour5538 Sep 10, 2026
fe89bf8
docs: add Ecosystem & Showcase section to README for OKF implementations
Saviour5538 Sep 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions okf/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -225,8 +225,23 @@ The HTML embeds the bundle as a JSON blob and uses
both loaded from a CDN. No data leaves the page; the bundle is parsed
once at generation time and serialized into the file.

## Ecosystem & Showcase

OKF is a universal, vendor-neutral format designed for broad interoperability across tools, agents, and human interfaces.

### Community Tools & Integrations

- **Interactive Graph Visualizer** — Self-contained HTML viewer using Cytoscape.js and Marked.js (bundled in this repo).
- **[okf-guard](https://github.com/GoogleCloudPlatform/open-knowledge-format)** — Integrity validator and linter for OKF bundles to enforce structural and schema consistency.
- **Knowledge Management Tooling** — Native compatibility with Obsidian, MkDocs, Notion, Hugo, and Jekyll for browsing and editing OKF bundles.

### Listing Your Project

Have you built an agent, exporter, linter, or visualization tool for OKF? We welcome additions! Open a pull request to add your project to this list.

## Tests

```
.venv/bin/pytest
```

2 changes: 1 addition & 1 deletion okf/SPEC.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -473,7 +473,7 @@ Several fields name a path or URI: `resource`, `sources[].resource`,
case it is not a path. Each path-valued field accepts:

- an absolute URL (for example `https://...`),
- a bundle-relative path beginning with `/`, or
- a bundle-relative path beginning with `/` (interpreted relative to the bundle root directory, not the filesystem or host domain root), or
- a relative path (for example `../computations/revenue.md`).

### 6.3 The `references/` convention
Expand Down