basalt 命令

basalt is a cross-platform terminal user interface (TUI) for managing Obsidian vaults and notes directly from the command line. It provides a minimalist interface with rendered markdown preview, vim-inspired navigation, and an experimental built-in editor. The interface consists of three main panes: the Explorer pane on the left for browsing notes and folders, the Note Editor pane in the center for reading notes with rendered markdown, and the Outline pane on the right for navigating headings within a note. Only one pane has focus at a time, indicated by a thicker border. basalt renders CommonMark and GitHub Flavored Markdown including headings, lists, task lists, code blocks, block quotes, Obsidian-style callouts, wiki-links, and inline code. Navigation uses vim-style keybindings: j/k or arrow keys to move, Tab/Shift+Tab to switch panes, Enter to open a note, t to toggle the explorer, Ctrl+O to toggle the outline, Ctrl+U/Ctrl+D for half-page scrolling, s to toggle sort order, and r to rename notes or folders. When renaming a note, all wiki-links referencing it are automatically updated throughout the vault. Global shortcuts include q to quit, ? to open the help modal, and Ctrl+G to open the vault selector for switching between Obsidian vaults. Custom commands can be configured to launch external editors or applications using the exec: and spawn: prefixes with dynamic variables %vault, %note, and %note_path. Built with Rust using ratatui for terminal rendering and pulldown-cmark for markdown parsing. The project is organized into three crates: basalt-core for domain logic, basalt-widgets for reusable TUI widgets, and basalt-tui for the main application.

Run `basalt` in a terminal, then adjust file names, paths, flags, or remote targets for your system.

This page includes 2 examples for basalt, plus related commands for nearby Linux tasks.