Get AI summaries of any video or article — Sign up free
A digital knowledge base for your organisation (+ new graph, namespaces, markdown headings & emojis) thumbnail

A digital knowledge base for your organisation (+ new graph, namespaces, markdown headings & emojis)

CombiningMinds·
5 min read

Based on CombiningMinds's video on YouTube. If you like this content, support the original creators by watching, liking and subscribing to their content.

TL;DR

A useful organizational knowledge base must capture relationships and dependencies, not just store documents.

Briefing

A digital knowledge base for an organization is less about storing documents and more about building a shared “mental map” of how systems, processes, and responsibilities connect—especially when key knowledge currently lives in individuals’ heads. The core promise is that teams can navigate internal information quickly, understand dependencies between services and SOPs, and reduce the churn cost when people leave. In practice, that means moving beyond a simple wiki into a structured, link-rich system that reflects the organization as a network.

The walkthrough centers on Logseq as an experimental foundation for this idea, using recent graph improvements plus several structuring techniques. Logseq’s updated graph view loads faster and presents a clearer network of pages (nodes) connected by links (edges). Clicking around the graph makes it easy to see how topics relate—useful for building intuition about where information lives and how it flows.

To organize content at scale, the experiment adds namespaces using forward slashes (e.g., “role/project manager”), creating a hierarchy of roles that can be browsed and linked. Markdown headings provide another layer of structure: heading levels are controlled with hashtags, and the notes emphasize avoiding formatting mistakes like missing spaces that can accidentally create unintended linked pages. For navigation and visual scanning, page names can include emojis, inserted via keyboard shortcuts (Windows key + period; Mac key + period). Emojis are used to make areas like “services” or “areas” feel more like a browsable map rather than a flat list.

The most concrete payoff comes from dependency tracking. A queried “landing page” for a team’s SOPs links into individual SOP entries that include metadata such as the services used and the areas affected. Within an SOP, roles and responsibilities are linked so that operational ownership can be traced: if a person leaves, the role link can be updated rather than hunting through scattered documents. The system also hints at an entity-relationship style approach through a “portal” concept, where services and their relationships can be mapped and then referenced as a repository for others.

Still, the setup comes with trade-offs. The biggest challenges are onboarding friction—new users may find the network-and-properties model unintuitive—and the need for careful structuring to avoid confusion about when to use properties versus namespaces. Privacy is also limited in the current approach, since pages are effectively public within the shared environment. There’s also concern about corruption risk tied to shared-drive workflows.

Finally, the creator positions Logseq as a near-term personal or small-team wiki that could become a true collaborative knowledge base as Logseq’s roadmap matures toward multi-user, database-style collaboration. In the meantime, alternatives are considered for non-self-hosted needs: Notion (powerful but can become complex), TiddlyWiki (open source), Coda (fixed pricing tied to creators), Confluence (Atlassian, subscription-based, includes a graph), and Slab (graph-like interface). The takeaway is that every company should build a knowledge base now, but the best tool—and the best collaboration model—may still be evolving.

Cornell Notes

The central idea is that organizations need a shared knowledge base that captures not just documents, but the relationships between systems, processes, and responsibilities. Using Logseq, the experiment demonstrates how a graph view (pages as nodes, links as edges) supports rapid navigation and helps reveal dependencies across SOPs and services. Namespaces (via forward slashes), Markdown headings (via hashtags), and emoji-labeled pages improve structure and readability. The approach also supports role-based linking so responsibilities can be updated when people leave. Key drawbacks include onboarding difficulty, uncertainty about optimal structuring (properties vs namespaces), and limited privacy in the current setup—while collaboration features are still expected to mature.

Why does a company need more than a “second brain” or a basic wiki?

Because organizational knowledge often lives in individuals’ heads and isn’t consistently documented. When that person leaves, rebuilding the knowledge can take a long time. A richer knowledge base aims to create a shared mental model by connecting databases, processes, and internal systems into a meta-layer that others can navigate and understand together.

How does Logseq’s graph view help with organizational understanding?

In the graph, pages appear as nodes and links appear as edges. Clicking a page and seeing connected lines makes it easier to trace relationships between topics—turning navigation into a network exploration rather than a folder or linear document search.

What do namespaces and Markdown headings add to the structure?

Namespaces use forward slashes to create hierarchical link paths (e.g., roles like “role/project manager”), letting users browse role hierarchies. Markdown headings use hashtags to define levels (heading 1, 2, 3, etc.), improving readability and making content easier to scan and reuse. The notes warn that missing spaces can accidentally create linked pages instead of headings.

How are emojis used, and what problem do they solve?

Emojis are inserted into page names to create visually distinct entry points—especially for areas like “services” and “areas.” They act as a hyperlinked navigation aid, making it faster to find the right page by visual cues. The walkthrough notes that a couple of emoji-related behaviors didn’t work perfectly, but overall they improved browsing.

How does the system represent dependencies between SOPs, services, and roles?

An SOP entry includes metadata such as the services it uses and the areas it affects. Roles and responsibilities are linked so that operational ownership can be traced. Instead of linking a person directly, the structure links roles; when someone leaves, the role assignment can be updated, reducing the risk of stale responsibility information.

What are the main limitations and risks of this approach today?

Onboarding is harder because network thinking and the properties/namespace model aren’t intuitive at first. Privacy is limited because pages are effectively public in the shared setup described. Setup correctness is uncertain (especially around when to use properties vs namespaces). There’s also concern about corruption tied to the shared-drive workflow used for collaboration before Logseq’s full collaborative roadmap arrives.

Review Questions

  1. What specific mechanisms in Logseq (graph view, namespaces, headings, emojis) contribute to faster navigation and better shared understanding?
  2. How does linking roles (rather than people) help keep SOP responsibility information accurate over time?
  3. Which drawbacks—familiarity, privacy, structuring uncertainty, or corruption risk—would most affect adoption in a real organization, and why?

Key Points

  1. 1

    A useful organizational knowledge base must capture relationships and dependencies, not just store documents.

  2. 2

    Logseq’s graph view turns pages and links into a navigable network that helps reveal how topics connect.

  3. 3

    Namespaces (forward slashes) provide hierarchical structure, while Markdown headings (hashtags) enforce readable content levels.

  4. 4

    Emoji-labeled page names can improve scanning and make navigation feel more like browsing a map.

  5. 5

    Dependency tracking becomes practical when SOP entries include metadata (services/areas) and link responsibilities through roles.

  6. 6

    Adoption risks include onboarding friction, uncertainty about structuring choices (properties vs namespaces), and limited privacy in shared setups.

  7. 7

    Collaboration quality depends on tooling maturity; Logseq’s roadmap toward true multi-user collaboration is positioned as the next major step.

Highlights

The graph view reframes knowledge navigation: pages are nodes and links are edges, so clicking around exposes the organization as a network.
Role-based linking is presented as a way to reduce churn: responsibilities can be reassigned when people leave without rewriting every SOP.
Namespaces plus Markdown headings create a lightweight hierarchy and readability layer that supports shared mental models.
Emoji page names function as a visual index for hyperlinked navigation across business areas.
The biggest near-term barriers are onboarding difficulty and privacy/structuring limitations until collaboration features mature.

Topics

  • Digital Knowledge Base
  • Logseq Graph
  • Namespaces
  • Markdown Headings
  • SOP Dependencies