#+OPTIONS: H:9 ^:nil
* Plugins

📝 NOTE: If you create a plugin for orgmode, make sure to tag it with =orgmode-nvim= on github and submit an issue/PR to add it to this list.

Orgmode supports various plugins to extend its functionality or make it more pretty and user friendly:

- [[#extend-orgmode][Extend orgmode]]
  - [[#org-super-agendanvim][org-super-agenda.nvim]]
  - [[#org-roamnvim][org-roam.nvim]]
  - [[#sniprun][sniprun]]
  - [[#org-notebooknvim][org-notebook.nvim]]
  - [[#telescope-orgmodenvim][telescope-orgmode.nvim]]
  - [[#org-linknvim][org-link.nvim]]
  - [[#org-cycle-litenvim][org-cycle-lite.nvim]]
- [[#completion-plugins][Completion plugins]]
  - [[#blinkcmp][blink.cmp]]
  - [[#nvim-cmp][nvim-cmp]]
  - [[#rldxnvim][RLDX.nvim]]
- [[#aesthetics][Aesthetics]]
  - [[#org-bulletsnvim][org-bullets.nvim]]
  - [[#headlinesnvim][headlines.nvim]]
  - [[#org-modernnvim][org-modern.nvim]]
- [[#other][Other]]
- [[#example-configuration][Example configuration]]

** Extend orgmode
:PROPERTIES:
:CUSTOM_ID: extend-orgmode
:END:
*** org-super-agenda.nvim
:PROPERTIES:
:CUSTOM_ID: org-super-agendanvim
:END:
Link: [[https://github.com/hamidi-dev/org-super-agenda.nvim][org-super-agenda.nvim]]

This is the port of Emacs [[https://github.com/alphapapa/org-super-agenda][org-super-agenda]].
*** org-roam.nvim
:PROPERTIES:
:CUSTOM_ID: org-roamnvim
:END:
Link: [[https://github.com/chipsenkbeil/org-roam.nvim][org-roam.nvim]]

This is the port of Emacs [[https://www.orgroam.com/][org-roam]].
*** sniprun
:PROPERTIES:
:CUSTOM_ID: sniprun
:END:
Link: [[https://github.com/michaelb/sniprun][sniprun]]

Plugin for code block evaluation.
*** org-notebook.nvim
:PROPERTIES:
:CUSTOM_ID: org-notebooknvim
:END:
Link: [[https://github.com/bitbloxhub/org-notebook.nvim][org-notebook.nvim]]

Jupyter notebooks for org-babel.
*** telescope-orgmode.nvim
:PROPERTIES:
:CUSTOM_ID: telescope-orgmodenvim
:END:
Link: [[https://github.com/nvim-orgmode/telescope-orgmode.nvim][telescope-orgmode.nvim]]

[[https://github.com/nvim-telescope/telescope.nvim][Telescope]] extension for orgmode that adds fuzzy finding of orgmode files, headlines, etc.

*** org-link.nvim
:PROPERTIES:
:CUSTOM_ID: org-linknvim
:END:
Link: [[https://github.com/seflue/org-link.nvim][org-link.nvim]]

Extends orgmode's capabilities to insert and follow links.

*** org-cycle-lite.nvim
:PROPERTIES:
:CUSTOM_ID: org-cycle-litenvim
:END:
Link: [[https://github.com/aaratha/org-cycle-lite.nvim][org-cycle-lite.nvim]]

Plugin for doom-emacs style simple cycling ([[https://github.com/doomemacs/doomemacs/blob/master/modules/lang/org/autoload/org.el#L497][org-cycle-only-current-subtree-h]])

** Completion plugins
:PROPERTIES:
:CUSTOM_ID: completion-plugins
:END:

📝 NOTE: There is experimental LSP support that provides the autocompletion. See [[file:./configuration.org::#lsp][Lsp section]] for more details.

*** blink.cmp
:PROPERTIES:
:CUSTOM_ID: blinkcmp
:END:
Link:  [[https://github.com/Saghen/blink.cmp][blink.cmp]]

Add the orgmode provider and enable it for =org= filetype.
#+begin_src lua
require('blink.cmp').setup({
  sources = {
    per_filetype = {
      org = {'orgmode'}
    },
    providers = {
      orgmode = {
        name = 'Orgmode',
        module = 'orgmode.org.autocompletion.blink',
        fallbacks = { 'buffer' },
      },
    },
  },
})
#+end_src

*** nvim-cmp
:PROPERTIES:
:CUSTOM_ID: nvim-cmp
:END:
Link: [[https://github.com/hrsh7th/nvim-cmp][nvim-cmp]]

Add the =orgmode= source to =nvim-cmp= ~sources~ list.
#+BEGIN_SRC lua
require('cmp').setup({
  sources = {
    { name = 'orgmode' }
  }
})
#+END_SRC

*** RLDX.nvim
:PROPERTIES:
:CUSTOM_ID: rldxnvim
:END:
Link: [[https://github.com/michhernand/RLDX.nvim][RLDX.nvim]]
1. Add [[https://github.com/michhernand/RLDX.nvim][RLDX.nvim]] plugin to Neovim.
2. Add the =cmp_rolodex= source to =nvim-cmp= ~sources~ list.
#+BEGIN_SRC lua
require('cmp').setup({
  sources = {
    { name = 'cmp_rolodex' }
  }
})
#+END_SRC

** Aestehtics
:PROPERTIES:
:CUSTOM_ID: aesthetics
:END:
*** org-bullets.nvim
:PROPERTIES:
:CUSTOM_ID: org-bulletsnvim
:END:
Link: [[https://github.com/nvim-orgmode/org-bullets.nvim][org-bullets.nvim]]
Port of Emacs [[https://github.com/sabof/org-bullets][org-bullets]].

Run after the orgmode setup.
#+BEGIN_SRC lua
-- Your orgmode setup
require('orgmode').setup()

--Setup org-bullets
require('org-bullets').setup()
#+END_SRC

*** headlines.nvim
:PROPERTIES:
:CUSTOM_ID: headlinesnvim
:END:
Link: [[https://github.com/lukas-reineke/headlines.nvim][headlines.nvim]]

Plugin that adds some additional highlights to headlines.
#+BEGIN_SRC lua
-- Your orgmode setup
require('orgmode').setup()

--Setup headlines.nvim
require("headlines").setup()
#+END_SRC


*** org-modern.nvim
:PROPERTIES:
:CUSTOM_ID: org-modernnvim
:END:
Link: [[https://github.com/danilshvalov/org-modern.nvim][org-modern.nvim]]

Modern looking agenda prompt menu.
#+begin_src lua
local Menu = require("org-modern.menu")

require("orgmode").setup({
  ui = {
    menu = {
      handler = function(data)
        Menu:new():open(data)
      end,
    },
  },
})
#+end_src

** Other
:PROPERTIES:
:CUSTOM_ID: other
:END:
To view all plugins that are tagged for =nvim-orgmode=, visit [[https://github.com/topics/orgmode-nvim][orgmode-nvim]] github tag.

📝 NOTE: If you create a plugin for orgmode, make sure to tag it with =orgmode-nvim= on github and submit an issue/PR to add it to this list.

** Example configuration
:PROPERTIES:
:CUSTOM_ID: example-configuration
:END:
Example configuration with few of these plugins using [[https://github.com/folke/lazy.nvim][lazy.nvim]]:
#+begin_src lua
{
  'nvim-orgmode/orgmode',
  dependencies = {
    'nvim-telescope/telescope.nvim',
    'nvim-orgmode/telescope-orgmode.nvim',
    'nvim-orgmode/org-bullets.nvim',
    'Saghen/blink.cmp'
  },
  event = 'VeryLazy',
  config = function()
    require('orgmode').setup({
      org_agenda_files = '~/orgfiles/**/*',
      org_default_notes_file = '~/orgfiles/refile.org',
    })
    require('org-bullets').setup()
    require('blink.cmp').setup({})

    -- Experimental LSP support
    vim.lsp.enable('org')
  end,
}
#+end_src