Anno is a thin user interface on Markdown files for easy and local text editing, organization, and portability.
Why use Anno?
There are many note-taking apps. How is Anno different? Anno is a local, browser-based user interface on top of Markdown files in a given directory. It makes writing, organizing, and searching through those files easy. That's it. There are many benefits to this approach:
Own your data. Writing things down is an investment in your future. Rather than have your notes siloed by a company in a possibly proprietary text format, your data lives in plaintext files on your machine. If you use Anno for a while and then stop, no worries. Your data, Markdown files, is human-readable, easily portable to other tools, and programmatically convertable to other formats (see Pandoc).
Organize notes naturally. Most note-taking apps create a new organizational system for your notes that is distinct from your filesystem. This forces you to store your notes separately from related files. Anno only works with
.anno.mdfiles in the current working directory, allowing you to organize your notes using your filesystem. Furthermore, all files with
labelsin the YAML-style front matter can be viewed in their respective collections, making intra-directory organization easy without touching your underlying directory structure.
Use other software. Anno adheres to the Unix philosophy of modular software that is simple, short, clear, and extensible. For example, data redundancy for text files is a solved problem, and Anno does not control users through product integration. Want cloud backups? Push to a git server or work out of a directory with file syncing. Want security? Encrypt the directory. Anno focuses on easy Markdown editing and organization.
What Anno supports
Anno provides a user interface for the most common and/or time-consuming text-editing operations.
- Previewing changes as you write.
- Writing equations using Katex.
- Searching through files.
- Organizing notes in a directory with labels.
- Adding images to notes.
- Syncing Markdown front matter (title and date) into consistently formatted filenames.
- Converting notes into LaTeX PDFs for easy printing and sharing.
Anno is available as a PyPI package. To install, run
pip install anno
You can also install the current development version by building and installing:
git clone [email protected]:gwgundersen/anno.git cd anno python setup.py sdist pip install dist/anno-<VERSION>.tar.gz
To use Anno, type
anno in the desired directory, e.g.
cd ~/myproject anno
and Anno will start a web server on port 5000 and open the app with your default browser. The port can be changed with the
--port flag, e.g.
If you would prefer Anno did not open a new browser tab, pass the