The Numerals plugin is a powerful tool that enables users to perform mathematical calculations and insert the results into their Obsidian notes. With this plugin, you can write complex math expressions in Markdown code blocks and evaluate them instantly. The plugin also offers advanced features such as result annotation, autocompletion of functions and variables, and style settings for customization. Additionally, Numerals supports mapping currency symbols to different currencies and allows users to specify the format of rendered results. Overall, this plugin is an excellent choice for anyone who needs to perform complex calculations or visualize data in their Obsidian notes.
🚀 Numerals 1.5 - Biggest Update Yet! 🚀
Introducing some of the most requested features including the ability to:
- sum previous lines with
@sum
or@total
- reference note frontmatter properties
- use global variables between blocks
- insert calculation results directly into your notes
Also new convenience features such as Greek letter auto-completion and custom currency support. Upgrade now and take your note-taking calculations to the next level!
Detailed Updates
⭐️ Sums and Totals of Previous Lines
- New feature and syntax for summing a group of lines:
@sum
or@total
(closes #18, #49, #36) - When Numerals encounters
@total
or@sum
it inserts the sum of all previous lines up until the last blank line or comment - Can use in a calculation or unit conversion
⭐️ Values in Note Frontmatter
Numerals can now reference note frontmatter or dataview inline values. Set the numerals
property on a page to share specific properties with all math blocks on a page.
In order to access metadata, you need to tell Numerals to make the value available by:
- Set the
numerals
metadata value (either frontmatter or dataview inline property) to the name of the value you want to include, or a list of values- Frontmatter of
numerals: other_metadata_name
, ornumerals: [metadata_1, metadata_2]
- inline value:
[numerals:: other_metadata_name]
- Frontmatter of
- Set the metadata value of
numerals
toall
: will index all metadata and make it available to dataview - Enable "Always Process All Frontmatter" in the Numerals settings
Numerals is able to write back to dataview values, through use of Result Insertion
⭐️ Note-wide Global Variables
Any variable name preceeded by an $
symbol will be made available to all math blocks on a page (closes #34)
⭐️ Result Insertion - Store Results in Raw Text
Using the new @[...]
syntax (for example: @[profit]
), Numerals will insert the results of a calculation into the raw text of your notes. (closes #22)
⭐️ Greek Letter Auto-complete
- Add greek letter auto-completion after typing
:
. e.g.:mu
in a math block will offerμ
as an auto-complete suggestion (closes #69) - Greek letters can be used in any variable name. They also work with subscripting when in
math-tex
block.
⭐️ Custom Currency Support
- Add custom currency support. In Numerals setting, user can set a currency symbol and name. (closes #54, #52, #61)
- Allows for example:
₿100 / day * 3 hours → 12.5 BTC
if you set ₿ as the custom currency: