Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/artempyanykh/zeta-note


https://github.com/artempyanykh/zeta-note

Last synced: 15 days ago
JSON representation

Awesome Lists containing this project

README

        

# Zeta Note

_Delightful note taking in markdown..._

[![Build & Test](https://github.com/artempyanykh/zeta-note/actions/workflows/push.yml/badge.svg?branch=main)](https://github.com/artempyanykh/zeta-note/actions/workflows/push.yml)

**THIS PROJECT IS RETIRED:**
Zeta Note has been retired as I don't have enough free time to continue
development in Rust. The product however lives on, and is [developed in F# under
the name `marksman`](https://github.com/artempyanykh/marksman).

---

Zeta Note is a language server that helps you write and manage notes. The
primary focus is to support [Zettelkasten-like][zettel-wiki][1](#fn1), [2](#fn2) note
taking by providing an easy way to **cross-reference notes** (see more about
features below).

But you don't have to go all-in on Zettelkasten method to benefit from Zeta Note:
1. Write your notes that way you like.
2. Cross-reference notes using _reference_ links:
- `[:another-note]` - a reference to another note.
- `[:another-note@##Subsection]` - a reference to a subsection of a note.
- `[:@##Inner subsection]` - a reference to a subsection of the current note.

Auto-completion provided by Zeta Note makes this process quick and easy.
3. **Go To Definition**, **Hover** preview, **Code Lenses**, and
**Diagnostics** simplify navigating and maintaining notes.

## Existing editor integrations[3](#fn3):

- VSCode via [Zeta Note VSCode][zn-vscode].
- Neovim 0.5+ via [nvim-lspconfig](https://github.com/neovim/nvim-lspconfig/blob/master/CONFIG.md#zeta_note).

## How to install

### Option 1: via `cargo install`

Given you have Rust and Cargo installed, run
```
cargo install zeta-note
```

The binary will be built and installed under a local Cargo folder (usually, `$HOME/.cargo/bin`).

### Option 2: use pre-built binary

1. Go to [Releases](https://github.com/artempyanykh/zeta-note/releases) page: each release has pre-built binaries for Linux, MacOS, and Windows. Download the binary for your OS.
2. Rename the binary and make it executable:
* MacOS: `mv zeta-note-macos zeta-note && chmod +x zeta-note`
* Linux: `mv zeta-note-linux zeta-note && chmod +x zeta-note`
* Windows: rename `zeta-note-windows.exe` to `zeta-note.exe`.
3. Place the binary somewhere in your `PATH`.
* XDG recommends using `$HOME/.local/bin/` (make sure this folder is in your `PATH`).

### Option 3: build from source
0. Install Rust and Cargo via [rustup](https://rustup.rs/).
1. Clone the repository: `git clone https://github.com/artempyanykh/zeta-note.git`
2. Inside `zeta-note` folder run `cargo install --path .`
3. The binary will be installed under `$HOME/.cargo/bin` (make sure this folder is in your `PATH`).

## Screenshots

- Hover preview:
![Hover](assets/readme/hover.png)
- Completion (note):
![Completion for note](assets/readme/completion-note.png)
- Completion (heading):
![Completion for heading](assets/readme/completion-heading.png)
- "Show References" Code Lens:
![Show references code lens](assets/readme/code-lens-show-refs.png)
- Project-wide diagnostics for broken references:
![Diagnostics](assets/readme/diagnostics.png)

## Features and plans

✅ - done; 🗓 - planned.

- ✅ Completion for references.
- ✅ Go to Definition for references.
- ✅ Hover prevew for references.
- ✅ Diagnostics about broken references.
- ✅ Code Lens with "# references" on headings.
- ✅ Support references in titles.
- ✅ Support multi-folder workspaces.
- 🗓 Rename refactor.
- 🗓 Support for Jupyter notebooks.
- 🗓 Custom parser for more fine-grained note structure.
- 🗓 Support heading slugs.
- 🗓 Add "check" command for standalone workspace checking.
- 🗓 Add "build" command that rewrites all cross-references into proper
relative markdown links for further embedding into a static site generator
such as Jekyll or Hakyll.
- 🗓 Add support for _regular_ links (diagnostics, completion, goto).
- 🗓 Add support for images (diagnostics, completion, goto).

---

\[1\]: You may have heard about [Roam Research][roam]. This is a commercial
implementation of the Zettelkasten method and another point of reference for
what Zeta Note is about. However, unlike a proprietary Roam Research, Zeta
Note is free, open-source and integrated into your favourite editor (albeit
for not not as feature rich as Roam Research).

\[2\]: There is an excellent VSCode extension called [Markdown
Memo][md-memo]. You definitely need to check it out if you're primarily using
VSCode as it has some features that are missing in Zeta Note and [Zeta Note
VSCode extension][zn-vscode]. However, Markdown Memo is VSCode specific while
Zeta Note is a generic language server, so can be used with any editor that
has LSP support: Emacs, Vim, Neovim, etc.

\[3\]: Since Zeta Note is a regular Language Server most of the functionality
works out of the box with any LSP client. The only thing that requires custom
handling is "Code Lenses" due to how these are defined in LSP spec.

\[4\]: [rust-analyzer](https://github.com/rust-analyzer/rust-analyzer) was a huge
source of inspiration for how to implement various parts of an LSP server in Rust. Thank you!

[zettel-wiki]: https://en.wikipedia.org/wiki/Zettelkasten
[roam]: https://roamresearch.com
[md-memo]: https://github.com/svsool/vscode-memo
[zn-vscode]: https://github.com/artempyanykh/zeta-note-vscode