literal programming with R notebooks, and Quarto rendering from within Obsidian:
Check out he website:
Up to date info and install guide: [https://michelnivard.github.io/Ridian/]
What this is:
-
A way to run R code in Obsidian
-
Full Quarto compliant code chunk processing (allows for seamless transition to other editors)
-
Parse a note and make it Quarto compliant, then render with Quarto
-
A way to keep notes on Coding/Statistics with enbedded working example
-
A way to use Obsidians amazingsearch and links to link code snippets
-
A way to use R code snippets to add plots/widgets to your notes
What this won't be:
-
An Rstudio replacement
-
an positro replacement
-
It wont cover other programming languages (5% chance of python), here is an excelent option for that: execute code plugin
Important
In the Ridian settings provide the path to your R/pandoc/quarto executables, The R executable can for example be at Mac: /usr/local/bin/R Windows: C:\Program Files (x86)\R\R-4.4.1\bin\R.exe
The plugin will try to guess the R install (and probably fail)
Demo.Video.mov
Render.with.Quarto.mov
Note
Seculity Disclosures:
Calls on External Executables: This plugin Executes code in R, an external intepreter, code execution comes with risk, you should at altimes know whether the code is save, don't execute untrusted code. File Access: The plugin accesses temporary directories to store plots and widgets, which are then copied the Obsidian vault under the plots/ and widgets/ folders.
Note
Known Issues/To-Do:
- uses absolute paths for htmlwidgets
- Every note spins up an R process, if you do this for many notes you'll overwhlm memory
- Only confirmed to work on MacOS on my mackbook & on Win 11's (on my macbook)
- No tests and other development necessities implemented
- No Contribution guilines (but help wanted!)
Here's a step-by-step guide to installing your Obsidian plugin, Ridian, using the BRAT (Beta Reviewers Auto-update Tool) plugin. This guide assumes you have Obsidian and BRAT already installed.
R package Dependecies: In R/Rstudio Install: languageserver
, evaluate
, jsonlite
& htmlwidgets
packages.
- Open Obsidian.
- Go to Settings > Community Plugins.
- Click Browse and search for "BRAT".
- Install BRAT and enable it by clicking Enable after installation.
-
In Obsidian, go to Settings > BRAT.
-
Under Beta Plugins List, click Add Beta Plugin.
-
Paste the GitHub repository URL for Ridian:
https://github.com/MichelNivard/Ridian
-
Click Add Plugin.
- After adding Ridian to BRAT, BRAT will automatically download it for you.
- Go to Settings > Community Plugins and find Ridian in the list of installed plugins.
- Enable Ridian by clicking Enable.
- Once enabled, check the Settings menu for any configuration options related to Ridian.
- Ensure you see options to configure or activate the plugin in Obsidian’s interface.
In R/Rstudio Install:
install.packages(evaluate)
install.packages(jsonlite)
install.packages(htmlwidgets)
In the Ridian settings provide the path to your R installation, which can for example be: Mac: /usr/local/bin/R Windows: C:\Program Files (x86)\R\R-4.4.1\bin\R.exe
After you set the path Ridian will adjust it for internal use (it might look different if you revisit the plugin.
Install pandoc (https://pandoc.org) and point Ridian to your pandoc install if you want to use htmlwidgets in R.
And that’s it! You now have Ridian installed and ready to use in Obsidian via BRAT.