emanote-template

emanote-template is a Git repository that comes up with ready-made settings for editing notes in Visual Studio Code and publishing to GitHub Pages (using Nix).

If you already have a GitHub account, click “Use this template” to use it right away. Otherwise, simply download it as a zip file and then unzip it.

Open the notebook in Visual Studio Code and install the recommended extensions.

Nix template

A Nix flake template is also provided if you want to do this in your existing notebook. Run:

nix flake init -t github:srid/emanote

This add a flake.nix file. You can follow emanote-template’s README from this point.

Links to this page

Visual Studio Code

Visual Studio Code is an open source editor that you can use to edit your plain-text notes. See emanote-template for a template notebook that includes extensions pre-configured for VSCode.
Using on Windows

Open the aforementioned emanote-template local copy

Run git clone https://github.com/srid/emanote-template.git to make a local copy of emanote-template in your Ubuntu instance
Using on Nix/NixOS

emanote-template uses this approach. See https://github.com/srid/emanote-template/blob/master/flake.nix
Installing

[!info] Avoiding installation Emanote need not have to be installed if you are using the emanote-template flake to manage your content.
Getting Started

Use your existing notebook, or create one from emanote-template^*.

emanote-template also includes the GitHub Pages workflow for static site deployment.
Adding Images

[!tip] The extension uses the traditional ![]() syntax to link to the image, but you may switch to using the wiki-link embedding syntax (![[]]) as it has the advantage of not needing to specify the full path to the image (thus allowing you to the move the image around under the notebook without breaking referring links). emanote-template is already configured to do this by default.