Skip to main content

Knowledge Explorer (Markdown-Centric)

Treat thousands of Markdown files like a GitBook/Docmost/Document360-style structured knowledge base, not a raw file system.

Layout Structure

Left Panel: Hierarchical Navigation

  • Hierarchy derived from:

    • Folder paths
    • Frontmatter metadata
  • Pinned collections:

    • "Clinical Policies"
    • "Risk Procedures"
    • "KYC Playbooks"

Center Panel: Markdown Renderer

Rendering Features:

  • Clean typography
  • Heading table of contents (TOC)
  • Intra-doc link highlighting

Supported Content:

  • Code blocks with syntax highlighting
  • Diagrams (Mermaid/UML)
  • Callouts and admonitions
  • Tables

Book Mode:

  • Multi-page reading experience
  • Similar to HackMD or GitBook
  • Previous/next navigation

Right Panel: Metadata & Compliance

Classification Info:

  • Security classification (PHI, confidential)
  • Document type
  • Jurisdiction
  • Applicable regulations (HIPAA, GDPR, SEC)

Version Info:

  • Version timeline
  • Change summary
  • Author history

Activity:

  • Who viewed/edited
  • When accessed
  • Recent changes

Search Capabilities

Search should be hybrid: full-text over Markdown plus filters over metadata and regulatory properties.

  • Search within Markdown content
  • Heading and section matching
  • Code block search

Metadata Filters

  • Document type
  • Classification
  • Jurisdiction
  • Regulations
  • Lifecycle status

Component Structure

// KnowledgeExplorer.tsx
interface KnowledgeExplorerProps {
currentDocument: Document | null;
navigation: NavigationTree;
onNavigate: (docId: string) => void;
}

// MarkdownRenderer.tsx
interface MarkdownRendererProps {
content: string;
onLinkClick: (href: string) => void;
enableTOC: boolean;
enableAnnotations: boolean;
}

// ComplianceMetadataPanel.tsx
interface ComplianceMetadataPanelProps {
classification: ClassificationLevel;
documentType: string;
jurisdiction: string[];
regulations: string[];
versionHistory: Version[];
activityLog: Activity[];
}

Similar Tools for Inspiration

ToolKey Features
GitBookClean reading experience, versioning
DocmostOpen source, Markdown-first
Document360Knowledge base with search
HackMDCollaborative Markdown editing

References