A Raycast extension that displays keyboard shortcuts and cheatsheets from a markdown file directly in Raycast's interface.
- Search shortcuts across all applications and categories
- Browse organized shortcuts by app/category sections
- View subsections for grouped shortcuts within apps
- Copy to clipboard any shortcut with one action
- Flexible path support with tilde (~) expansion for home directory
- Download Raycast (macOS only)
- Node.js (v20+ recommended)
- Clone this repository
- Install dependencies:
npm install
- Build and link to Raycast:
npm run dev
After installing, configure the extension in Raycast preferences:
- Cheatsheet Path: Path to your markdown cheatsheet file (e.g.,
~/Documents/shortcuts.md)
The extension supports two markdown formats: standard markdown and Obsidian callout syntax.
## Application Name
### Navigation
| Key | Description |
| --- | --- |
| Cmd+K | Command palette |
| Cmd+P | Quick open file |
### Editing
| Key | Description |
| --- | --- |
| Cmd+Z | Undo |
| Cmd+Shift+Z | Redo |
## Another App
| Key | Description |
| --- | --- |
| Ctrl+A | Select all |> [!IMPORTANT] Application Name
> **Navigation**
> | Key | Description |
> | --- | --- |
> | Cmd+K | Command palette || Element | Standard Markdown | Obsidian Callout |
|---|---|---|
| Section | ## Name |
> [!IMPORTANT] Name |
| Subsection | ### Name |
> **Name** |
| Shortcut Row | | Key | Description | |
> | Key | Description | |
For more information on building Raycast extensions, see the Raycast Developer Documentation.
| Command | Description |
|---|---|
npm run dev |
Start development server |
npm run build |
Build for distribution |
npm run lint |
Check code quality |
npm run fix-lint |
Auto-fix linting issues |
keyboardy/
├── src/
│ ├── index.tsx # Main Raycast command component
│ ├── parser.ts # Markdown file parser
│ └── types.ts # TypeScript interfaces
├── assets/
│ └── command-icon.png
├── package.json
└── tsconfig.json
- The extension reads the markdown file specified in preferences
- The parser extracts sections, subsections, and shortcut tables
- Shortcuts are displayed in a searchable Raycast list
- Users can search, browse, and copy shortcuts to clipboard
MIT
