mirror of
https://github.com/Ascyii/typstar.git
synced 2026-01-01 05:24:24 -05:00
5.5 KiB
5.5 KiB
Typstar
Neovim plugin for efficient note taking in Typst
Features
- Powerful autosnippets using LuaSnip and Tree-sitter (inspired by fastex.nvim)
- Easy insertion of drawings using Obsidian Excalidraw
- Export of Anki flashcards [No Neovim required]
Usage
Snippets
Use :TypstarToggleSnippets to toggle all snippets at any time.
Available snippets can mostly be intuitively derived from here, they include:
- Alphanumeric characters:
:<char>→$<char>$in markup (e.g.:X→$X$,:5→$5$) - Greek letters:
;<latin>→<greek>in math and$<greek>$in markup (e.g.;a→alpha/$alpha$) - Common indices (numbers and letters
i-n):<letter><index>→<letter>_<index>in math and$<letter>$<index>→$<letter>_<index>$in markup (e.gA314→A_314,$alpha$n→$alpha_n$) - Wrapping of any mathematical expression (see operations, works nested, multiline and in visual mode via the selection key):
<expression><operation>→<operation>(<expression>)(e.g.(a^2+b^2)rt→sqrt(a^2+b^2),lambdatd→tilde(lambda),(1+1)sQ→[1+1],(1+1)sq→[(1+1)]) - Matrices:
<size>maand<size>lma(e.g.23ma→ 2x3 matrix) - ctheorems shorthands (e.g.
tem→ empty theorem,exa→ empty example) - Many shorthands for mathematical expressions
Note that you can enable and disable collections of snippets in the config.
Excalidraw
- Use
:TypstarInsertExcalidrawto create a new drawing using the configured template, insert a figure displaying it and open it in Obsidian. - To open an inserted drawing in Obsidian, simply run
:TypstarOpenExcalidrawwhile your cursor is on a line referencing the drawing.
Anki
Use the flA snippet to create a new flashcard
#flashcard(0, "My first flashcard")[
Typst is awesome $a^2+b^2=c^2$
]
or the fla snippet to add a more complex front
#flashcard(0)[I love Typst $pi$][
This is the back of my second flashcard
]
To render the flashcard in your document as well add some code like this
#let flashcard(id, front, back) = {
strong(front)
[\ ]
back
}
- Add a comment like
// ANKI: MY::DECKto your document to set a deck used for all flashcards after this comment (You can use multiple decks per file) - Add a file named
.anki.typto define a preamble on a directory base. You can find the default preamble here. - Tip: Despite the use of SVGs you can still search your flashcards in Anki as the typst source is added into an invisible html paragraph
Neovim
- Use
:TypstarAnkiScanto scan the current nvim working directory and compile all flashcards in its context, unchanged files will be ignored - Use
:TypstarAnkiForceto force compilation of all flashcards in the current working directory even if the files haven't changed since the last scan (e.g. on preamble change) - Use
:TypstarAnkiForceCurrentto force compilation of all flashcards in the file currently edited
Standalone
- Run
typstar-anki --helpto show the available options
Installation
Install the plugin in Neovim and set the typstarRoot config or alternatively clone typstar into ~/typstar.
require('typstar').setup({
typstarRoot = '/path/to/typstar/repo' -- depending on your nvim plugin system
})
Snippets
- Install LuaSnip, set
enable_autosnippets = trueand set a visual mode selection key (e.g.store_selection_keys = '<Tab>') in the configuration - Install jsregexp as described here (running
:lua require('jsregexp')in nvim should not result in an error) - Install nvim-treesitter and run
:TSInstall typst - Optional: Setup ctheorems with names like here
Excalidraw
- Install Obsidian and create a vault in your typst note taking directory
- Install the obsidian-excalidraw-plugin and enable
Auto-export SVG(in plugin settings atEmbedding Excalidraw into your Notes and Exporting > Export Settings > Auto-export Settings) - Have the
xdg-opencommand working or set a different command aturiOpenCommandin the config
Anki
- Install Anki
- Install Anki-Connect and make sure
http://localhostis added towebCorsOriginListin the Add-on config (should be added by default) - Install the typstar python package (I recommend using pipx via
pipx install git+https://github.com/arne314/typstar) [Note: this may take a while] - Make sure the
typstar-ankicommand is available in yourPATHor modify thetypstarAnkiCmdoption in the config
Configuration
Configuration options can be intuitively derived from the table here.