nextcloud / notes

✎ Distraction-free notes and writing
https://apps.nextcloud.com/apps/notes
GNU Affero General Public License v3.0
623 stars 133 forks source link
distraction-free markdown markdown-editor nextcloud nextcloud-notes notes

Notes

REUSE status

The Notes app is a distraction free notes taking app for Nextcloud. It provides categories for better organization and supports formatting using Markdown syntax. Notes are saved as files in your Nextcloud, so you can view and edit them with every Nextcloud client. Furthermore, a separate REST API allows for an easy integration into apps (Android, iOS, and 3rd-party apps like the console and many more which allow convenient access to your Nextcloud notes). Further features include marking notes as favorites.

Screenshot of Nextcloud Notes

:rocket: Installation

In your Nextcloud, simply navigate to »Apps«, choose the category »Office«, find the Notes app and enable it. Then open the Notes app from the app menu.

Nextcloud will notify you about possible updates. Please have a look at CHANGELOG.md for details about changes.

:exclamation: Bugs

Before reporting bugs:

:busts_in_silhouette: Maintainers

:warning: Developer Info

Lint Test

Building the app

  1. Clone this into your apps folder of your Nextcloud
  2. In a terminal, run the command make dev-setup to install the dependencies
  3. Then to build the Javascript run make build-js or make watch-js to rebuild it when you make changes
  4. Enable the app through the app management of your Nextcloud

REST API for third-party apps

The notes app provides a JSON-API for third-party apps. Please have a look at our API documentation.

Admin configuration

It is possible to specify different defaults for the notes settings of new users using occ commands like these:

occ config:app:set notes noteMode --value="preview"
occ config:app:set notes fileSuffix --value=".md"
occ config:app:set notes defaultFolder --value="Shared notes"
Setting Property name Default Other available option(s)
Display mode for notes noteMode edit preview
File extension for new notes fileSuffix .txt .md
Folder to store your notes defaultFolder Notes Custom