No description
Find a file
Kisaragi Hiu 82ac6b6b9c
Some checks failed
Docs / build (push) Has been cancelled
CI / build (snapshot) (push) Has been cancelled
(internal): speed up extraction of global props, headlines, and title (#1061)
Avoids usage of org-element-parse-buffer, preferring simple regex searches.
2020-08-24 22:14:15 +08:00
.github (internal): Exclude org-roam-compat.el from linting (#713) 2020-05-28 01:22:51 -04:00
doc (feat): allow ignoring files matching a regular expression (#1046) 2020-08-18 16:16:56 +08:00
tests (internal): speed up extraction of global props, headlines, and title (#1061) 2020-08-24 22:14:15 +08:00
.dir-locals.el (feat): Switch to a minor-mode for the dev-suite (#805) 2020-06-12 22:01:52 +02:00
.gitignore (docs): track landing page (#620) 2020-05-13 19:26:37 +08:00
BACKERS.md (doc): Add Andreas to backers (#969) 2020-07-25 16:33:36 +08:00
CHANGELOG.md (internal): speed up extraction of global props, headlines, and title (#1061) 2020-08-24 22:14:15 +08:00
default.mk (internal): use Make and Org to build manual (#546) 2020-05-03 18:06:27 +08:00
LICENSE Add GPL License 2020-02-12 21:47:57 +08:00
Makefile (ci): make multi-page manual (#618) 2020-05-13 18:56:42 +08:00
makem.sh (internal): make lint errors fail CI, and disable spellcheck during linting (#561) 2020-05-04 15:17:39 +08:00
org-roam-buffer.el (feat): support fuzzy links (#910) 2020-08-05 20:52:27 +08:00
org-roam-capture.el (feat): add org-capture interactive options to org-roam-capture (#1035) 2020-08-16 19:51:37 +08:00
org-roam-compat.el (internal): fix CI for compat functions (#1031) 2020-08-12 00:04:15 +08:00
org-roam-completion.el (release): Org-roam v1.2.1 (#975) 2020-07-27 01:03:35 +08:00
org-roam-dailies.el (internal): remove with-template-error wrapper (#1004) 2020-08-06 10:51:24 +08:00
org-roam-db.el (feat): add org-roam-enable-headline-linking (#1030) 2020-08-13 11:18:06 +08:00
org-roam-dev.el (release): Org-roam v1.2.1 (#975) 2020-07-27 01:03:35 +08:00
org-roam-doctor.el (release): Org-roam v1.2.1 (#975) 2020-07-27 01:03:35 +08:00
org-roam-faces.el (internal): move faces into own file (#987) 2020-07-30 09:12:56 +08:00
org-roam-graph.el (release): Org-roam v1.2.1 (#975) 2020-07-27 01:03:35 +08:00
org-roam-macs.el (internal): fix CI for compat functions (#1031) 2020-08-12 00:04:15 +08:00
org-roam-protocol.el (internal): fix CI for compat functions (#1031) 2020-08-12 00:04:15 +08:00
org-roam.el (internal): speed up extraction of global props, headlines, and title (#1061) 2020-08-24 22:14:15 +08:00
README.md (doc): Add target audience section (#990) 2020-07-31 02:15:42 +08:00

License GPL 3 GitHub Release MELPA

Synopsis

NOTE: Org-roam builds upon Emacs and Org-mode, both of which are intricate tools that require time investment for mastery. This makes Org-roam less friendly for beginners, but extremely powerful for those familiar with the ecosystem, or willing to invest effort in it.

Org-roam is a Roam replica built on top of the all-powerful Org-mode.

Org-roam is a solution for effortless non-hierarchical note-taking with Org-mode. With Org-roam, notes flow naturally, making note-taking fun and easy. Org-roam should also work as a plug-and-play solution for anyone already using Org-mode for their personal wiki.

Org-roam aims to implement the core features of Roam, leveraging the mature ecosystem around Org-mode where possible. Eventually, we hope to further introduce features enabled by the Emacs ecosystem.

@technovangelist has produced a video describing Org-roam and the concepts behind it:

Making Connections in your Notes

Important links:

A Preview

Here's a screencast of Org-roam. The org-roam-buffer (window on the right) shows backlinks for the active Org-roam buffer (window on the left), as well as the surrounding content in the backlink file. The database is built once, and updated incrementally. The graph is generated from the link structure, and can be used to navigate to the respective files.

img

Installation

You can install org-roam using package.el:

M-x package-install RET org-roam RET

Here's a sample configuration with using use-package:

(use-package org-roam
      :ensure t
      :hook
      (after-init . org-roam-mode)
      :custom
      (org-roam-directory "/path/to/org-files/")
      :bind (:map org-roam-mode-map
              (("C-c n l" . org-roam)
               ("C-c n f" . org-roam-find-file)
               ("C-c n g" . org-roam-graph-show))
              :map org-mode-map
              (("C-c n i" . org-roam-insert))
              (("C-c n I" . org-roam-insert-immediate))))

org-roam-graph by default expects to find the dot executable from the graphviz package in the exec-path. Ensure graphviz is installed and found if you want to use this feature or customize your configuration for org-roam-graph to use a different tool.

For more detailed installation and configuration instructions (including for Doom and Spacemacs users), please see the documentation.

Frequently-asked Questions

Q: How do I create a note whose title already matches one of the candidates (e.g. creating bar when barricade already exists)?

A: With ivy, you need to press C-M-j to use the current input instead of the nearest candidate. (Source: ivys FAQ)

Getting Help

Before creating a new topic/issue, please be mindful of our time and ensure that it has not already been addressed on GitHub or on Discourse.

  • If you are new to Emacs and have problem setting up Org-roam, please ask your question on Slack, channel #how-do-i.
  • For quick questions, please ask them on Slack, channel #troubleshooting.
  • If something is not working as it should, or if you would like to suggest a new feature, please create a new issue.
  • If you have questions about your workflow with the slip-box method, please find a relevant topic on Discourse, or create a new one.

Knowledge Bases using Org-roam

Changelog

A changelog is being maintained here

Contributing

To report bugs and suggest new feature use the issue tracker. If you have some code which you would like to be merged, then open a pull request. Please also see CONTRIBUTING.md.

License

Copyright © Jethro Kuan and contributors. Distributed under the GNU General Public License, Version 3