Class Notebook

config

currentRenderFilePath

fs

hasLoadedNotes

markdownYoRenderer

md

notebookPath

notes

previewScriptsEnabled

referenceMap

tagReferenceMap

trustedScriptRoots

buildMarkdownYoOptions

• buildMarkdownYoOptions(isForPreview: boolean): RenderOptions

  Build markdown_yo render options from the current notebook config.

  Parameters

  • isForPreview: boolean

  Returns RenderOptions

clearAllNoteMarkdownEngineCaches

• clearAllNoteMarkdownEngineCaches(): void

  Returns void

deleteNote

• deleteNote(filePath: string, alreadyDeleted?: boolean): Promise<void>

  Delete a note and update the internal note relations and search index.

  Parameters

  • filePath: string

    Note to delete.

  • alreadyDeleted: boolean = false

    Set to true when the caller has already removed the file from disk (e.g. a filesystem watcher reacting to a deletion event). In that case the file is left untouched — a replacement file recreated at the same path (e.g. by a Git checkout) must survive — and only the internal bookkeeping is refreshed.

  Returns Promise<void>

getAllTags

• getAllTags(): string[]

  List every tag that has been mentioned anywhere in the notebook. Tags are case-folded, so the returned values are lowercase.

  Returns string[]

getBacklinkedNotes

• getBacklinkedNotes(filePath: string): Promise<Notes>

  Parameters

  • filePath: string

  Returns Promise<Notes>

getNote

• getNote(filePath: string, refreshNoteRelations?: boolean): Promise<Note | null>

  Parameters

  • filePath: string
  • refreshNoteRelations: boolean = false

  Returns Promise<Note | null>

getNoteBacklinks

• getNoteBacklinks(filePath: string): Promise<Backlink[]>

  Parameters

  • filePath: string

  Returns Promise<Backlink[]>

getNoteMarkdown

• getNoteMarkdown(filePath: string): Promise<string | null>

  Read a note's markdown body, lazily. Always reads from disk and runs the same front-matter normalisation as getNote — the body is intentionally not cached on Note, so this is the canonical way to fetch it.

  Returns null for files that aren't markdown (extension not in markdownFileExtensions), are missing, or exceed maxNoteFileSize.

  Parameters

  • filePath: string

  Returns Promise<string | null>

getNoteMarkdownEngine

• getNoteMarkdownEngine(filePath: string): MarkdownEngine

  Parameters

  • filePath: string

  Returns MarkdownEngine

getNoteMarkdownEngines

• getNoteMarkdownEngines(): { [key: string]: MarkdownEngine }

  Returns { [key: string]: MarkdownEngine }

getNotesReferringToTag

• getNotesReferringToTag(tag: string): Promise<Notes>

  Notes that mention a given #tag, anywhere in the notebook. Tag is matched case-insensitively.

  Reads from the in-memory notes map — same rationale as getBacklinkedNotes: re-loading each referrer from disk would be N async hops for no win, since the index can only contain referrers we already loaded.

  Parameters

  • tag: string

  Returns Promise<Notes>

getReferences

• getReferences(
      noteFilePath: string,
      backlinkedNoteFilePath: string,
  ): Promise<Reference[]>

  Parameters

  • noteFilePath: string
  • backlinkedNoteFilePath: string

  Returns Promise<Reference[]>

getTagBacklinks

• getTagBacklinks(tag: string): Promise<Backlink[]>

  Same shape as getNoteBacklinks, but for a #tag rather than a note filepath. Each Backlink groups a referrer note with the individual #tag references inside it (token + rendered HTML).

  Parameters

  • tag: string

  Returns Promise<Backlink[]>

getTocMarkdownIt

• getTocMarkdownIt(): MarkdownIt

  A markdown-it instance for rendering the sidebar TOC, with source maps disabled. parseMD renders the TOC on every preview update, so the instance is created lazily and reused until the live-updated markdown-it options change.

  Returns MarkdownIt

initFs

• initFs(_fs?: FileSystemApi): void

  Parameters

  • Optional_fs: FileSystemApi

  Returns void

initMarkdownIt

• initMarkdownIt(options?: ExtendedMarkdownItOptions): MarkdownIt

  Parameters

  • Optionaloptions: ExtendedMarkdownItOptions

  Returns MarkdownIt

processNoteMentionsAndMentionedBy

• processNoteMentionsAndMentionedBy(
      filePath: string,
      markdownOverride?: string,
  ): Promise<void>

  Parameters

  • filePath: string
  • OptionalmarkdownOverride: string

  Returns Promise<void>

processWikilink

• processWikilink(
      content: string,
  ): { blockRef?: string; hash?: string; link: string; text: string }

  Process wiki link

  Parameters

  • content: string

    content is string like "Test", "test.md | Test"

  Returns { blockRef?: string; hash?: string; link: string; text: string }

refreshNotes

• refreshNotes(args: RefreshNotesArgs): Promise<Notes>

  Parameters

  • args: RefreshNotesArgs

  Returns Promise<Notes>

refreshNotesIfNotLoaded

• refreshNotesIfNotLoaded(
      __namedParameters: RefreshNotesIfNotLoaded,
  ): Promise<Notes>

  Parameters

  • __namedParameters: RefreshNotesIfNotLoaded

  Returns Promise<Notes>

refreshNotesIncremental

• refreshNotesIncremental(args: RefreshNotesArgs): Promise<Notes>

  Incremental version of refreshNotes: instead of wiping the indices and rebuilding from scratch, walk the workspace and only re-process files whose on-disk mtime has advanced past the value recorded in processedMtimes (set during the most recent full refresh or prior incremental refresh). Newly-added files are processed; cached entries that no longer exist on disk are removed (their reference / tag entries cleaned up).

  Designed to be cheap to call from a file-system watcher. The directory walk still has to stat every file under dir, but the O(N) markdown re-tokenisation is skipped for unchanged files.

  Shares the refreshNotesMutex with refreshNotes so the two can't race against each other.

  Parameters

  • args: RefreshNotesArgs

  Returns Promise<Notes>

removeNoteRelations

• removeNoteRelations(filePath: string): Promise<void>

  Parameters

  • filePath: string

  Returns Promise<void>

renderMarkdown

• renderMarkdown(markdown: string, options?: { isForPreview?: boolean }): string

  Render markdown to HTML using markdown_yo (WASM) if available, otherwise falls back to markdown-it.

  Parameters

  • markdown: string
  • Optionaloptions: { isForPreview?: boolean }

  Returns string

resolveNoteAbsolutePath

• resolveNoteAbsolutePath(filePath: string): string

  Get the absolute path of the note

  Parameters

  • filePath: string

  Returns string

resolveNoteRelativePath

• resolveNoteRelativePath(filePath: string): string

  Get the relative path of the note to the notebook directory

  Parameters

  • filePath: string

  Returns string

resolveWikilink

• resolveWikilink(link: string, currentNoteFilePath: string): string

  Resolve a wiki link file path to a notebook-root-relative path. Used by both index-time mention tracking and render-time embed resolution so both paths agree on link resolution.

  Parameters

  • link: string

    — the file portion of the link (after processWikilink, without fragment/hash/block-id)

  • currentNoteFilePath: string

    — the notebook-relative path of the note containing this link

  Returns string

  notebook-root-relative file path

updateConfig

• updateConfig(config: Partial<NotebookConfig>): void

  Parameters

  • config: Partial<NotebookConfig>

  Returns void

Staticinit

• init(args: NotebookConstructorArgs): Promise<Notebook>

  Parameters

  • args: NotebookConstructorArgs

  Returns Promise<Notebook>