Core Highlights
Pages 42
-
- core.highlights
- No Colour Means no Productivity
- Overview
- Configuration
- Handles the dimming of certain highlight groups.It sometimes is favourable to use an existing highlight group, but to dim or brighten it a little bit.To do so, you may use this table, which, similarly to the highlights table, will concatenate nested trees to form a highlight group name.The difference is, however, that the leaves of the tree are a table, not a single string. This table has three possible fields:reference - which highlight to use as reference for the dimming.percentage - by how much to darken the reference highlight. This value may be between -100 and 100, where negative percentages brighten the reference highlight, whereas positive values dim the highlight by the given percentage.
- The TS highlights for each Neorg type.The highlights table is a large collection of nested trees. At the leaves of each of these trees is the final highlight to apply to that tree. For example: "+@comment" tells Neorg to link to an existing highlight group @comment (denoted by the + prefix). When no prefix is found, the string is treated as arguments passed to :highlight, for example: gui=bold fg=#000000.Nested trees concatenate, thus:tags = { ranged_verbatim = { begin = "+@comment", }, } matches the highlight group:@neorg.tags.ranged_verbatim.begin and converts into the following command:highlight! link @neorg.tags.ranged_verbatim.begin @comment
- Highlights for the anchor syntax: [name]{location}.
- Highlights for definitions ($ Definition).
- Highlights for all the delimiter types. These include:--- - the weak delimiter=== - the strong delimiter___ - the horizontal rule
- In case of errors in the syntax tree, use the following highlight.
- Highlights for footnotes (^ My Footnote).
- Highlights for each individual heading level.
- Highlights for all the possible levels of ordered and unordered lists.
- Highlights for inline markup.This is all the highlights like bold, italic and so on.
- Inline modifiers.This includes:~ - the trailing modifierAll link characters ({, }, [, ], <, >)The escape character (\)
- Highlights for all the possible levels of quotes.
- Highlights displayed in Neorg selection window popups.
- Highlights displayed in all sorts of tag types.These include: @, ., |, #, + and =.
- Highlights for the carryover (#, +) tags.
- Highlights for the content of any tag named comment.Most prominent use case is for the #comment carryover tag.
- Highlights for the @ verbatim tags.
- Highlights for TODO items.This strictly covers the ( ) component of any detached modifier. In other words, these highlights only bother with highlighting the brackets and the content within, but not the object containing the TODO item itself.
- How to change the colour of TODO items depending on their state.This can be one of four values: false, "all", "except_undone" and "cancelled".When set to false the content of TODO items will not be coloured in any special way.When set to "all" the content of TODO items will directly reflect the colour of the item's TODO box.When set to "except_undone", will have the same behaviour as "all" but will exclude undone TODO items.When set to "cancelled" will only highlight the content of TODO items for cancelled tasks.
- Required Modules
- Required By
Inbuilt modules:
core.autocommands
core.clipboard
core.clipboard.code-blocks
core.defaults
core.export
core.export.markdown
core.fs
core.highlights
core.integrations.nvim-cmp
core.integrations.nvim-compe
core.integrations.treesitter
core.integrations.truezen
core.integrations.zen_mode
core.itero
core.looking-glass
core.mode
core.neorgcmd
core.neorgcmd.commands.module.list
core.neorgcmd.commands.module.load
core.neorgcmd.commands.return
core.norg.completion
core.norg.concealer
core.norg.dirman
core.norg.dirman.utils
core.norg.esupports.hop
core.norg.esupports.indent
core.norg.esupports.metagen
core.norg.journal
core.norg.manoeuvre
core.norg.news
core.norg.qol.toc
core.norg.qol.todo_items
core.presenter
core.promo
core.queries.native
core.scanner
core.storage
core.syntax
core.tangle
core.upgrade
Clone this wiki locally
Overview
core.highlights
maps all possible highlight groups available throughout
Neorg under a single tree of highlights: @neorg.*
.
Configuration
-
dim
(table)Handles the dimming of certain highlight groups.
It sometimes is favourable to use an existing highlight group, but to dim or brighten it a little bit.
To do so, you may use this table, which, similarly to the
highlights
table, will concatenate nested trees to form a highlight group name.The difference is, however, that the leaves of the tree are a table, not a single string. This table has three possible fields:
-
reference
- which highlight to use as reference for the dimming. -
percentage
- by how much to darken the reference highlight. This value may be between-100
and100
, where negative percentages brighten the reference highlight, whereas positive values dim the highlight by the given percentage.
-
markup
(table)
-
inline_comment
(table)
-
percentage
(number)
40
-
reference
(string)
"Normal"
-
-
verbatim
(table)
-
percentage
(number)
20
-
reference
(string)
"Normal"
-
-
-
tags
(table)
-
ranged_verbatim
(table)
-
code_block
(table)
* <details> <summary><code>affect</code> (string)</summary> <br> ```lua "background" ``` </details> * <details> <summary><code>percentage</code> (number)</summary> <br> ```lua 15 ``` </details> * <details> <summary><code>reference</code> (string)</summary> <br> ```lua "Normal" ``` </details>
-
-
-
-
highlights
(table)The TS highlights for each Neorg type.
The
highlights
table is a large collection of nested trees. At the leaves of each of these trees is the final highlight to apply to that tree. For example:"+@comment"
tells Neorg to link to an existing highlight group@comment
(denoted by the+
prefix). When no prefix is found, the string is treated as arguments passed to:highlight
, for example:gui=bold fg=#000000
.Nested trees concatenate, thus:
tags = { ranged_verbatim = { begin = "+@comment", }, }
matches the highlight group:
@neorg.tags.ranged_verbatim.begin
and converts into the following command:
highlight! link @neorg.tags.ranged_verbatim.begin @comment
-
headings
(table)Highlights for each individual heading level.
-
1
(table)
-
prefix
(string)
"+@attribute"
-
title
(string)
"+@attribute"
-
-
2
(table)
-
prefix
(string)
"+@label"
-
title
(string)
"+@label"
-
-
3
(table)
-
prefix
(string)
"+@constant"
-
title
(string)
"+@constant"
-
-
4
(table)
-
prefix
(string)
"+@string"
-
title
(string)
"+@string"
-
-
5
(table)
-
prefix
(string)
"+@label"
-
title
(string)
"+@label"
-
-
6
(table)
-
prefix
(string)
"+@constructor"
-
title
(string)
"+@constructor"
-
-
-
links
(table)
-
description
(table)
-
delimiter
(string)
"+NonText"
-
-
file
(table)
-
delimiter
(string)
"+NonText"
-
-
location
(table)
-
definition
(table)
* <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@neorg.definitions.prefix" ``` </details>
-
delimiter
(string)
"+NonText"
-
external_file
(table)
* <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@label" ``` </details>
-
footnote
(table)
* <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@neorg.footnotes.prefix" ``` </details>
-
generic
(table)
* <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@type" ``` </details>
-
heading
(table)
* <details> <summary><code>1</code> (table)</summary> <br> * <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@neorg.headings.1.prefix" ``` </details> </details> * <details> <summary><code>2</code> (table)</summary> <br> * <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@neorg.headings.2.prefix" ``` </details> </details> * <details> <summary><code>3</code> (table)</summary> <br> * <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@neorg.headings.3.prefix" ``` </details> </details> * <details> <summary><code>4</code> (table)</summary> <br> * <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@neorg.headings.4.prefix" ``` </details> </details> * <details> <summary><code>5</code> (table)</summary> <br> * <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@neorg.headings.5.prefix" ``` </details> </details> * <details> <summary><code>6</code> (table)</summary> <br> * <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@neorg.headings.6.prefix" ``` </details> </details>
-
marker
(table)
* <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@neorg.markers.prefix" ``` </details>
-
url
(string)
"+@text.uri"
-
-
-
lists
(table)Highlights for all the possible levels of ordered and unordered lists.
-
ordered
(table)
-
1
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details> * <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@repeat" ``` </details>
-
2
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details> * <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@repeat" ``` </details>
-
3
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details> * <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@repeat" ``` </details>
-
4
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details> * <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@repeat" ``` </details>
-
5
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details> * <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@repeat" ``` </details>
-
6
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details> * <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@repeat" ``` </details>
-
-
unordered
(table)
-
1
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details> * <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@punctuation.delimiter" ``` </details>
-
2
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details> * <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@punctuation.delimiter" ``` </details>
-
3
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details> * <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@punctuation.delimiter" ``` </details>
-
4
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details> * <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@punctuation.delimiter" ``` </details>
-
5
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details> * <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@punctuation.delimiter" ``` </details>
-
6
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details> * <details> <summary><code>prefix</code> (string)</summary> <br> ```lua "+@punctuation.delimiter" ``` </details>
-
-
-
markup
(table)Highlights for inline markup.
This is all the highlights like
bold
,italic
and so on.-
bold
(table)
-
delimiter
(string)
"+NonText"
-
-
free_form_delimiter
(string)
"+NonText"
-
inline_comment
(table)
-
delimiter
(string)
"+NonText"
-
-
inline_macro
(table)
-
delimiter
(string)
"+NonText"
-
-
inline_math
(table)
-
delimiter
(string)
"+NonText"
-
-
italic
(table)
-
delimiter
(string)
"+NonText"
-
-
spoiler
(table)
-
delimiter
(string)
"+NonText"
-
-
strikethrough
(table)
-
delimiter
(string)
"+NonText"
-
-
subscript
(table)
-
delimiter
(string)
"+NonText"
-
-
superscript
(table)
-
delimiter
(string)
"+NonText"
-
-
underline
(table)
-
delimiter
(string)
"+NonText"
-
-
verbatim
(table)
-
delimiter
(string)
"+NonText"
-
-
-
quotes
(table)Highlights for all the possible levels of quotes.
-
1
(table)
-
content
(string)
"+@punctuation.delimiter"
-
prefix
(string)
"+@punctuation.delimiter"
-
-
2
(table)
-
content
(string)
"+Blue"
-
prefix
(string)
"+Blue"
-
-
3
(table)
-
content
(string)
"+Yellow"
-
prefix
(string)
"+Yellow"
-
-
4
(table)
-
content
(string)
"+Red"
-
prefix
(string)
"+Red"
-
-
5
(table)
-
content
(string)
"+Green"
-
prefix
(string)
"+Green"
-
-
6
(table)
-
content
(string)
"+Brown"
-
prefix
(string)
"+Brown"
-
-
-
tags
(table)Highlights displayed in all sorts of tag types.
These include:
@
,.
,|
,#
,+
and=
.-
carryover
(table)Highlights for the carryover (
#
,+
) tags.-
begin
(string)
"+@label"
-
name
(table)
* <details> <summary><code>delimiter</code> (string)</summary> <br> ```lua "+@none" ``` </details> * <details> <summary><code>word</code> (string)</summary> <br> ```lua "+@label" ``` </details>
-
parameters
(string)
"+@string"
-
-
ranged_verbatim
(table)Highlights for the
@
verbatim tags.-
begin
(string)
"+@keyword"
-
document_meta
(table)
* <details> <summary><code>array</code> (table)</summary> <br> * <details> <summary><code>bracket</code> (string)</summary> <br> ```lua "+@punctuation.bracket" ``` </details> * <details> <summary><code>value</code> (string)</summary> <br> ```lua "+@none" ``` </details> </details> * <details> <summary><code>authors</code> (string)</summary> <br> ```lua "+@annotation" ``` </details> * <details> <summary><code>categories</code> (string)</summary> <br> ```lua "+@keyword" ``` </details> * <details> <summary><code>created</code> (string)</summary> <br> ```lua "+@float" ``` </details> * <details> <summary><code>description</code> (string)</summary> <br> ```lua "+@label" ``` </details> * <details> <summary><code>key</code> (string)</summary> <br> ```lua "+@field" ``` </details> * <details> <summary><code>object</code> (table)</summary> <br> * <details> <summary><code>bracket</code> (string)</summary> <br> ```lua "+@punctuation.bracket" ``` </details> </details> * <details> <summary><code>title</code> (string)</summary> <br> ```lua "+@text.title" ``` </details> * <details> <summary><code>trailing</code> (string)</summary> <br> ```lua "+@repeat" ``` </details> * <details> <summary><code>updated</code> (string)</summary> <br> ```lua "+@float" ``` </details> * <details> <summary><code>value</code> (string)</summary> <br> ```lua "+@string" ``` </details> * <details> <summary><code>version</code> (string)</summary> <br> ```lua "+@float" ``` </details>
-
end
(string)
"+@keyword"
-
name
(table)
* <details> <summary><code>delimiter</code> (string)</summary> <br> ```lua "+@none" ``` </details> * <details> <summary><code>word</code> (string)</summary> <br> ```lua "+@keyword" ``` </details>
-
parameters
(string)
"+@type"
-
-
-
todo_items
(table)Highlights for TODO items.
This strictly covers the
( )
component of any detached modifier. In other words, these highlights only bother with highlighting the brackets and the content within, but not the object containing the TODO item itself.-
cancelled
(table)
-
1
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
2
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
3
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
4
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
5
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
6
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
-
done
(table)
-
1
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
2
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
3
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
4
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
5
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
6
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
-
on_hold
(table)
-
1
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
2
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
3
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
4
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
5
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
6
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
-
pending
(table)
-
1
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
2
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
3
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
4
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
5
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
6
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
-
recurring
(table)
-
1
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
2
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
3
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
4
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
5
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
6
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
-
uncertain
(table)
-
1
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
2
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
3
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
4
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
5
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
6
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
-
undone
(table)
-
1
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
2
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
3
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
4
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
5
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
6
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
-
urgent
(table)
-
1
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
2
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
3
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
4
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
5
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
6
(table)
* <details> <summary><code>content</code> (string)</summary> <br> ```lua "+@none" ``` </details>
-
-
-
todo_items_match_color
(string)How to change the colour of TODO items depending on their state.
This can be one of four values:
false
,"all"
,"except_undone"
and"cancelled"
.- When set to
false
the content of TODO items will not be coloured in any special way. - When set to
"all"
the content of TODO items will directly reflect the colour of the item's TODO box. - When set to
"except_undone"
, will have the same behaviour as"all"
but will exclude undone TODO items. - When set to
"cancelled"
will only highlight the content of TODO items for cancelled tasks.
"cancelled"
- When set to
Required Modules
-
core.autocommands
- Handles the creation and management of Neovim's autocommands.
Required By
-
core.integrations.treesitter
- A module designed to integrate Treesitter into Neorg.