The Sublime-less Zettelkasten

This is a note taking app that enables clickable ID-based Wiki-style links, and #tags in your plain text (Markdown) documents.

If you follow the (plain-text) Zettelkasten method (as proposed by Zettelkasten.de or takesmartnotes.com), this might appeal to you.

In short, it helps you manage an archive of interlinked notes that look like this:

In addition to being a specialized Markdown text-editor and text-browser, Sublimeless_ZK is loaded with features for text-production:

sophisticated search methods for finding (associated) notes that
- reference the same #tag combination
- or cite a certain source
- or are linking to a certain note
- contain a certain combination of words
- are referenced (=linked to) a min/max number of times
- are un-referenced
expanding notes containing links to other notes (overview notes) into notes notes containing the linked notes' contents
- can be refreshed if source notes change
- refresh can be enabled / disabled on a per contained note basis
parameterized templates for new notes
easy insertion of links, #tags, and citation-keys via fuzzy-search
auto-insertion (and removal) of section numbers
auto-insertion of tables of contents
auto-insertion of bibliographies
export to stand-alone semantic text view HTML
support for external commands, e.g. to create PDFs

See the Usage section below to see how this package might support your workflow.

Alternatively, watch it in action 😄

This app is the result of trying to make a stand-alone version of sublime_zk, the SublimeText Zettelkasten package.

Main Features

(This app is still in active development. If you like, stay up to date with latest developments at: Its dedicated Zettelkasten.de Forum Thread)

Place wiki style links like [[this]] or [this] into your notes to link to other notes in your note archive.
Clicking such a link will open the corresponding note in a new tab.
Pressing alt and clicking a link will search for all notes also referencing the linked note ('friend notes').
Typing [[ will open a list of existing notes so you can quickly link to existing notes.
[shift]+[enter] lets you enter a name for a new note. The new note is then created with a new note ID.
Implicit note creation by clicking links to non-existing notes' titles, see below.
The ID format is timestamp-based YYYYMMDDHHMM - eg: 201710282111, but can be switched second-precision YYYYMMDDHHMMSS - eg: 20171224183045
Highlighting of #tags and @citekeys.
Typing #! will display all your #tags, sorted, in the search results area
#? opens up a list of all your #tags and lets you fuzzy search and select them (like note-links).
Clicking a #tag or @citekey will search for all notes containing this tag / citekey.
Expansion of overview notes with selective refresh!!!
Templates for new notes
Optional insertion of [[links]] WITH note titles instead of just [[links]]
Inline expansion of note links, tags, and citekeys via ctrl+.
Searching for advanced tag combinations
Find in files
Automatic Bibliographies, and fuzzy-search insertion of citations
Automatic Table Of Contents
Automatic Section Numbering
Color Schemes
Saved Searches
HTML Export into a semantic text view
Command Palette
External Commands:
- Can create PDFs, e.g. via pandoc, as the provided examples
- Can automatically open the created PDF, HTML, ...
- Can create new notes
- Can update existing notes

Installation
- Windows
- macOS
- Linux
- Installing Pandoc
Usage
Configuration
Credits

Installation

There are no installers. Just download and enjoy.

The releases section of the GitHub repository provides binary downloads for up-to-date versions of both Windows 10 (64bit), macOs, and Linux.

Windows

Built and tested on Windows 10 (64bit) only: Rumors have it that it works on Windows 8.1 but if you don't run Windows 10 64bit, don't expect it to run. Volunteers helping to build releases for other versions of Windows are welcome to contact me on GitHub.

Download the Windows ZIP (sublimeless_zk-pre-x.y-win10.zip) from the GitHub release archive
Unzip sublimeless_zk-pre-x.y-win10.zip
In the resulting sublimeless_zk-pre-x.y-win10 folder, sublimeless_zk.exe is the program you want to run.

Note: On many systems, the extension .exe is not shown.

macOS

Download the macOS ZIP (sublimeless_zk-pre-x.y-macOS.app.zip) from the GitHub release archive
Unzip sublimeless_zk-pre-x.y-macOS.app.zip
sublimeless_zk-pre-x.y.app is the program you want to run.

Linux

Download the Linux .tar.gz (sublimeless_zk-pre-x.y-linux.tar.gz) from the GitHub release archive
Unpack sublimeless_zk-pre-x.y-linux.tar.gz
In the resulting sublimeless_zk-pre-x.y-linux folder, sublimeless_zk is the program you want to run.

Alternative Linux Installation

If the above method doesn't work, you can try running the sources directly

Install python 3.6 (eg, from Anaconda)
Install required packates: pip3 install pyqt5 qscintilla jstyleson fuzzyfinder pymmd markdown pypandoc pygments bibtexparser
- build the Multimarkdown shared library for pymmd (required for HTML export): python3 -c "import pymmd; pymmd.build_mmd()"
- for that to work you need a working C compiler and cmake:
  - sudo apt-get install cmake gcc g++ binutils
Download or git clone the sources directly from GitHub
change into the src folder
run python3 sublimeless_zk.py

Installing Pandoc

Whether you use Pandoc or not for Markdown processing, the AutoBib feature requires it. Luckily it is easy to install.

Usage

This app comes with sane defaults. You can start using it right away. Once you have become accustomed, it is worth checking out the Configuration section, though.

Shortcut cheatsheet

Command Palette ctrl/cmd + shift + P
Fuzzy search and open note ctrl/cmd + P
Goto Open Note / Heading ctrl/cmd + shift + G
Show / Hide right side-panel : ctrl/cmd + shift + K
Show / Hide status bar : ctrl/cmd + shift + J
Show / Hide open files panel : shift + alt/opt + K
Create a new note shift + enter
New note from text Select text, then shift + enter
New note from text link : Click [the text link]
Rename note: ctrl/cmd + shift + R
Find in files ctrl/cmd + shift + F
Find notes by number of links to them ctrl/cmd + shift + W
Open link with keyboard Cursor in link, then ctrl + enter
Cycle tabs ctrl/cmd + shift + [ (left) and ctrl/cmd + shift + ] (right)
Insert link [ + [
Find referencing (friend) notes ALT + click link to note
View all tags # + !
View all notes [ + !
Browse note history : alt/option> + shift ctrl/cmd + H
Insert tag # + ?
Find tag references: Just click a #tag
Expand link inline ctrl + .
Expand tag inline (with referencing notes) ctrl + .
Expand citekey inline (with referencing notes) ctrl + .
Insert multimarkdown citation [ + # (needs "citations-mmd-style": true)
Insert pandoc citation [ + @ (needs "citations-mmd-style": false)
Increase Font Size: ctrl/cmd + = or ctrl/cmd + +
Decrease Font Size: ctrl/cmd + -
Move line up: ctrl/cmd + shift + U
Move line down: ctrl/cmd + shift + D
Run external command: ctrl/cmd + shift + X

User Interface

As you can see in the various screenshots, the user interface is split into four areas; they are:

very left (optional): open files panel
- this panel is hidden by default. You can show it by:
- Menu: View > Toggle Open Files Panel
- Keyboard Shortcut shift + alt/opt + K
- Command Palette (described later): "Toggle Open Files Panel"
left: note editor tabs
right: side-panel
- top right: search results area
  - will display results of various implicit or explicit searches you perform
- bottom right: saved searches area
bottom: status bar

Menus

There are keyboard shortcuts for almost everything, but sometimes it is just handy to browse through the menus.

Let's introduce them!

sublimeless_zk (only on macOS)
- About sublimeless_zk : Show about dialog
- Preferences... : Opens the settings file for editing.
File
- New Zettel Note : create a new note
- Open Notes Folder : switch to another note folder
- Save : save the current file (note or settings or saved searches)
- Save All : save all files
- Browse notes to open : fuzzy-search through notes, select to open
- Rename note... : rename the current note
- Delete note... : delete the current note
- Export archive to HTML... : HTML Export
- 1: most recent notes folder : opens it
- 2: second most recent notes folder : opens it
- ...
- 9: ninth most recent notes folder : opens it
Edit
- Undo : undo last action in current editor
- Redo : redo last action in current editor
- Copy : copy selected text to clipboard
- Cut : cut selected text to clipboard
- Paste : paste clipboard into current editor
- Move Line Up : move the current line one line up, cool for lists
- Move Line Down: move the current line one line down, cool for lists
- Editor:
  - Toggle Auto-Indent : auto-indent on/off
  - Toggle Line Wrap : line wrap on/off
  - Toggle Wrap Markers: show / hide markers at the end of wrapping lines
  - Toggle Wrap Indent: indent wrapped lines even further
  - Toggle Indentation Guides: show hide guides for indented lines
  - Toggle TAB / Spaces : toggle TAB inserts TAB or spaces
- Insert Link to Note : insert a link via fuzzy search panel
- Insert Tag : insert a tag via fuzzy search panel
- Expand Link : expand a link / tag / citekey inline in the line below
- Insert Citation : insert a citation key via fuzzy search panel
- Insert Bibliography : insert bibliography of all cited sources in current note
- Insert Table of Contents : insert a table of contents into current note
- Insert Section Numbers : prefix headings with section numbers
- Remove Section Numbers : remove section numbers from headings if present
- Settings... (Windows only) : Opens the settings file for editing
Search
- Find/replace... : show search and (optionally) replace dialog to find/replace text in current editor
- Find in files : search for text in all notes
- Search for Tag Combination : Advanced Tag Search
- Find notes with references... : Search for notes that are linked to a certain number of times (within a range)
View
- Show Command Palette... : does exactly that
- Cycle forwards through tabs: open next tab
- Cycle backwards through tabs: open previous tab
- Goto... : Go to open note or a specific heading within an open note
- Toggle Side Panel : Show / hide the side panel
- Toggle Status Bar : Show / hide the status bar
- Toggle Open Files Panel : Show / hide the open files panel
- Show all notes : shows all notes in the search results
- Show recently viewed notes : Shows a "browsing history" of recently opened notes
- Show all referencing notes : If cursor is in a link / tag / citation key, search for all notes with the same reference (link/tag/citekey)
- Show all Tags: shows a tag list in the search results
- New Theme... : Create a new theme
- Switch Theme... : Switch to a different theme
- Edit Theme... : edit the current theme
- Full Screen (macOS only) : go full screen
Tools
- Reload BIB file : Do this when your .bib file has changed
- Expand Overview Note : create new note from current one where all links are replaced by contents
- Refresh expanded Note: Refresh such an expanded note if sources have changed
- Run External Command... : Fuzzy select an external command to run
- Edit external commands... : Edit external commands
About (Windows, Linux only) : Shows the about dialog

Command Palette

As alternative to the menus, you can also use the command palette, triggered by pressing ctrl/cmd + shift + P.

You can fuzzy-search for any menu command there and select it by pressing return or double-clicking it.

The following animation shows the command palette in action:

Side Panel

The side-panel shows the current search results at the top for you to click and your saved searches at the bottom.

Note: You can show and hide the side panel with View > Toggle Side Panel or ctrl/cmd + shift + K.

Status Bar

The status bar at the bottom shows the following information:

line count of the current note
word cound of the current note
editor status information

The above image shows:

38 lines in the current note
130 words in the current note
line wrap is on (Y)
line wrapping markers are shown (+show)
wrapped lines are indented (+indent)
auto-indent is on (auto)
indentation guides are shown (yes)

Note: You can show and hide the status bar with View > Toggle Status Bar or ctrl/cmd + shift + J.

Switching Themes

View > Switch Theme ... will open a fuzzy-searchable list of all installed themes. When you select a theme it will be applied immediately.

Only a few color schemes are provided by default.

You can read more on defining your own themes in Customizing Themes.

Office Color Scheme

Monokai Color Scheme

There is also a variant monokai-large-headings:

Solarized Color Scheme

If you want the best aesthetics, download the Ubuntu Mono fonts and install the following 4 by double-clicking them:

UbuntuMono-R.ttf
UbuntuMono-RI.ttf
UbuntuMono-B.ttf
UbuntuMono-BI.ttf

C64 Color Scheme

For a perfect C64 experience, download the best C64 True Type Font, unzip it, and install the C64 Pro Mono.ttf by double clicking it.

Clickable Links

Links in the app are click-able. Everything that's underlined (or highlighted in the saved searches), can be clicked. Links trigger an action, which could be one of the following:

open a note
trigger a search (tag, citation, find-in-files, history, ...)
open a hyperlink in the browser
open a hyperlink in another app

Examples:

The latter two might need some explanations:

If you put a Markdown link in a note, like this: [link to website](https://www.zettelkasten.de), then you can open the linked-to web page by simply clicking the link.

You can even link to other applications on your system; here is an example for DevonThink: [link to devon-think](x-devonthink-item://3240FC0C-E669-461A-8814-2D078A619E77?page=0).

Note Archive Folder

When you first start the app, it creates a zettelkasten folder in your home / user directory. On Windows, this is typically C:\Users\your.username\zettelkasten, on macOS it is typically /Users/your.username/zettelkasten, and on Linux it usually is /home/your.username/zettelkasten.

This zettelkasten folder comes with one or more default notes to get you started.

If you have an existing note archive already, you can switch to it with ctrl/cmd+O, or use the File > Open... menu.

The app keeps track of up to 10 recently opened note archive folders, which are accessible at the bottom of the File menu.

Creating a new note

Press [shift]+[enter]. This will prompt you for the title of the new note.
Press [ESC] to cancel without creating a new note.
Enter the note title and press [enter].

A new note will be created and assigned the timestamp based ID in the format described above.

Example: Let's say you entered "AI is going to kill us all" as the note title, then a file with the name 201710282118 AI is going to kill us all.md will be created and opened for you.

The new note will look like this:

# AI is going to kill us all
tags =
.

Creating a new note and link from selected text

There is a very convenient shortcut to create notes from selected text and automatically inserting a link to the new note, replacing the selected text: Just select the text you want to use as note title before pressing [shift]+[enter].

This will bring up the same input field at the bottom of the window, this time pre-filled with the selected text. When you press [enter], a new note will be created, using the selected text as its title. In addition, the selected text in the original note will be replaced by a link to the new note.

As a bonus feature, you can even select multiple lines and create a new note complete with title and body:

the first selected line will become the note's title
all the other selected lines will become the note's body (text).

Creating a link

Let's assume, you work in the note "201710282120 The rise of the machines":

# The rise of the machines
tags = #AI #world-domination

Machines are becoming more and more intelligent and powerful.

This might reach a point where they might develop a consciensce of their own.

You figure, a link to the "AI is going to kill us all" note is a good fit to expand on that aspect of the whole machine-rise story, so you want to place a link in there.

You start typing:

# The rise of the machines
tags = #AI #world-domination

Machines are becoming more and more intelligent and powerful.

This might reach a point where they might develop a consciensce of their own.

As a consequence, they might turn evil and try to kill us all ........... [[

The moment you type [[, a list pops up with all the notes in your archive. You enter "kill" to narrow down the selection list and select the target note. Voila! You have just placed a link into your note, which now looks like this:

# The rise of the machines
tags = #AI #world-domination

Machines are becoming more and more intelligent and powerful.

This might reach a point where they might develop a consciensce of their own.

As a consequence, they might turn evil and try to kill us all ........... [[201710282118]]

Note: Only files ending with the extension specified in the settings (.md by default) will be listed in the popup list. If your files end with .txt, you need to change this setting.

Note: With this setting you can have the note's title inserted right after the link as well: [[201710282118]] AI is going to kill us all

If you now click into [[201710282118]], the target note will be opened in a new tab where you can read up on how AI is potentially going to kill us all.

Here you can see what the list of notes to choose from looks like:

Implicitly creating a new note via a link

There is another way to create a new note: Just create a link containing its title and click it.

To showcase this, let's modify our example from above: Say, the "AI is going to kill us all" does not exist and you're in your "The rise of the machines" note.

This is what it might look like:

# The rise of the machines
tags = #AI #world-domination

Machines are becoming more and more intelligent and powerful.

This might reach a point where they might develop a consciensce of their own.

You now want to branch into the new thought you just had, that AI might potentially eventually be going to kill us all. You prepare for that by mentioning it and inserting a link, like this:

# The rise of the machines
tags = #AI #world-domination

Machines are becoming more and more intelligent and powerful.

This might reach a point where they might develop a consciensce of their own.

As a consequence, they might turn evil and try to kill us all ........... [[AI is going to kill us all]]

Note: You will have to press [ESC] after typing [[ to get out of the note selection that pops up, before entering the note title.

Note: Of course this also works if you use a single quote link: [AI is going to kill us all].

Now, in order to actually create the new note and its link, all you have to do is to click inside the new note's title, just as you would if you wanted to open a regular linked note.

And voila! A new note 201710282118 AI is going to kill us all.md will be created and opened for you.

But the really cool thing is, that the link in the original note will be updated to the correct ID, so again you will end up with the following in the parent note:

# The rise of the machines
tags = #AI #world-domination

Machines are becoming more and more intelligent and powerful.

This might reach a point where they might develop a consciensce of their own.

As a consequence, they might turn evil and try to kill us all ........... [[201710282118]]

Note how the note title "AI is going to kill us all" has been replaced by the note's ID "201710282118".

Note: With this setting you can have the note's title inserted right after the link as well, like in : [[201710282118]] AI is going to kill us all

The new note will be pre-filled with the following text:

# AI is going to kill us all
tags =
.

Supported link styles

When inserting links manually, you are can choose between the following supported link styles:

## Wiki Style
[[201711111707]] Ordinary double-bracket wiki-style links

## Wiki Style with title
[[201711111708 here goes the note's title]] same with title

## Single-Pair
[201711111709] one pair of brackets is enough

## Single-Pair with title
[201711111709 one pair of brackets is enough]
.

This is how they are rendered:

Searching for friends

If you see a link in a note and wonder what other notes also reference this note, then that is easy enough to do: Just hold down the alt key when clicking the link. Alternatively, place the cursor inside the link and press alt+enter.

Listing all notes

The shortcut [ + ! produces a list of all notes in the search results.

Browsing through notes

To quickly open a note, you can open the note browser with ctrl/cmd + P. This will let you fuzzy-search your notes and open the one you select.

Navigating open notes

You can jump to any open note or even an individual heading within an open note with the "Goto..." command from the command palette, via the View > Goto... menu or by pressing ctrl/cmd + shift + G.

Headings are prefixed with their # markup and appear below their note in the fuzzy-searchable list.

The following animation shows how this works:

Browsing recently opened notes

Sometimes you want some sort of "browse history", to see what notes you have viewed or modified recently. Well, there's a command for that:

View > Show recently viewed notes
"Show recently viewed notes" from the command palette
Press alt/option + shift ctrl/cmd + H
Click on the saved search View History : =view_history(){sortby: history}

It produces an overview of your history in the search results like this:

# Recently Opened Notes

## Last hour
* [[201804250103]] Working with Bibliographies
* [[201804141018]] Welcome
* [[201804250052]] Creating a Link
* [[201804250048]] Working with Notes
* [[201804250059]] Working with Tags
* [[201804250100]] Advanced Tag Search

## Last 24 hours

## Last 7 days

## Last 30 days

Browsing recently modified notes

This is only available via an advanced saved search. By default, your saved searches contain the line:

Recent notes : [! {sortby: mtime, order: desc}

This command basically means: Show all notes like [! does, then sort them by modification time in descending order. When you click the (blue) search, the search results will show the list of recently modified notes.

Find in files

shift+ctrl/cmd+F brings up a panel that lets you enter text you search for. On enter, the search results area will show links to notes containing your search-term.

The search is case-insensitive: hello will match Hello.
If you enter multiple words, only notes containing all those words will be shown. So when you search for hello world, a note containing hello new world will be found. A note only containing hello or world will not be found.
If you have text selected in the current editor, the panel will be pre-filled with that text
If your what you search for contains blanks, you can use ""double quotation marks""
If you want to exclude words or ""double quoted strings"", then prefix them with !!

Examples:

hello world : searches for notes containing hello and world
""hello world"" : searches for notes containing hello world
!!""hello world"" : searches for notes not containing hello world
!!hello world : searches for notes not containing hello and containing world.

Find notes by number of links to them

Sometimes you might want to know which notes are not linked to by other notes or which notes are linked to by at least 10 other notes. There's a command for that: Search > Find notes with references..., in the command palette "Find notes with references...", also accessible via the shortcut ctrl/cmd + shift + W.

You will be asked for the minimum (default: 0) and maximum (default:1000) number of times notes to find must be linked to. On OK, the results will show up in the search-results area.

Searching for un-referenced notes or even most-referenced notes is more powerful in the form of a saved search, because you can specify the sort order there. See Reference Counts : Find un-referenced and most-referenced notes for how to do that.

This is also shown in the example below:

Working with tags

Getting an overview of all your tags

Over time you might collect quite a number of #tags assigned to your notes. Sometimes it helps to get an overview of all of them, maybe to check for synonyms before creating a tag, etc.

When you press #! (that is the # key followed by the ! key) quickly, the search results will list all your #tags right next to your text:

Inserting Tags

Press #+? to ask for a list of all tags used in your note archive. You can narrow down the search and finally pick the tag you like.

Searching for notes containing specific tags

Like note-links, tags can also be "followed" by clicking them. This will produce a list of notes tagged with that tag in the search results area.

Advanced Tag Search

To search for more sophisticated tag combinations, use the command Search for Tag Combination (Control + T) from the search menu.

It will prompt you for the tags you want to search for and understands quite a powerful syntax; let's walk through it:

Grammar and Syntax

search-spec: search-term [, search-term]*
search-term: tag-spec [ tag-spec]*
tag-spec: [!]#tag-name[*]
tag-name: {any valid tag string}

What does that mean?

search-spec consist of one or more search-terms that are separated by comma
each search-term consists of one or more tag-specs
each tag-spec
- can be:
  - #tag : matches notes tagged with #tag
  - !#tag : matches all results that are not tagged with #tag
- and optionally be followed by an * asterisk to change the meaning of #tag
  - from exact #tag
  - to tags starting with #tag

How does this work?

Each search is performed in the order the search-terms are specified.
- With each search-term the results can be narrowed down.
- This is equivalent to a logical AND operation
- Example: #car, #diesel will first search for #car and then narrow all #car matches down to those also containing #diesel.
  - This is equivalent to #car AND #diesel.
Each tag-spec in a search-term adds to the results of that search-term.
- This is equivalent to a logical OR operation.
- Example: #car #plane will match everything tagged with #car and also everything tagged with #plane
  - This is equivalent to #car OR #plane.
Each tag-spec can contain an * asterisk placeholder to make #tag* stand for all tags starting with #tag
- This works for #tag* and !#tag*.
- Examples:
  - #car* : will match everything that contains tags starting with #car, such as: #car, #car-manufacturer, etc.
  - !#car* : will match all results that do not contain tags starting with #car:
    - #plane #car-manufacturer will be thrown away
    - #submarine will be kept

Putting it all together

Examples:

#transport !#car : all notes with transport + all notes not containing car (such as #plane)

There is no comma. Hence, two search terms will be evaluated and the results of all of them will be combined (OR).

#transport, !#car: all notes with transport - all notes containing car

Here, there is a comma. So first all notes tagged with #transport will be searched and of those only the ones that are not tagged with #car will be kept (AND).

Pretty powerful.

#transport #car, !#plane : #transport or #car but never #plane

#transport #car !#plane : #transport or #car or anything else that's not #plane

I omitted examples using the * placeholder, it should be pretty obvious.

The following screen-shots illustrate the advanced tag search in action:

the first one shows the results for ##AI:
- two notes match
- one of them is tagged with ##AI #world-domination
the first one shows the results for ##AI, !#world*:
- only one note matches
- it is tagged with ##AI
- the note from before is also tagged with #world-domination which gets eliminated by , !#world*.

Expansion of overview notes with selective refresh

Expansion of overview notes

Let's say you have an overview note about a topic that links to specifics of that topic that looks like this:

O - Text production

This is an **overview note** about text production with the Zettelkasten method.

A few general words about our tool: Sublime ZK
[[201711111707]] Sublime ZK is awesome
[[201711111708]] Sublime ZK is great

Then we go more in-depth:
[[201711111709]] The specifics of how we produce text with the plugin

Cool!

This overview is just a collection of note links with brief descriptions and a bit of additional text.

Now, if you wanted to turn this overview note into a text containing the contents of the linked notes instead of just the links, then you can expand the note like this:

Use the Tools menu: Tools > Expand Overview Note
Control + E

You will be asked for the name of your new overview note et voila! Depending on your linked notes, the overview note will be expanded into a new note, maybe looking like this:

As you can see, the lines containing note links are replaced by the contents of their corresponding notes, enclosed in comment lines. You can now edit and save this file to your liking.

Note: If you want to refresh this expanded overview (see below) later, then please leave those comments in!

Note:: If you modify the text of a linked note (between comment lines), then remove the extra ! to prevent your change to get overwritten when refreshing this overview.

Refreshing an expanded overview note

It might happen that you change some notes that are already expanded into your new expanded overview note. If that happens and you have left the comments in, then you can refresh the expanded overview:

Use the Tools menu: Tools > Refresh expanded Note
Control + V

Note: Only notes with comments starting with <!-- ! will be considered for a refresh.

Tip: That means: To keep your edits of specific expanded notes from being overwritten by a refresh, just delete the extra !, making the comment start with <!-- . Alternatively, you can, of course, delete the comment lines for parts you are sure will never need refreshing.

The following animation illustrates expansion and refreshing:

Inline expansion of note-links

Overview note expansion is cool, but there are situations where you might not want to expand all links of a note but just a few. Also, since expansion does not descend into links of expanded notes, you might want to manually expand those.

Manually expanding a note link is easy: You must have your cursor in a note link, obiously. The key combination [ctrl]+[.] or Expand Link inline from the edit menu will then trigger the expansion. In contrast to the expansion method for overview notes in the previous section, the line containing the link will be preserved.

Here is an example using the already well-known AI notes: Let's start with our first note:

# The rise of the machines
tags = #AI #world-domination

Machines are becoming more and more intelligent and powerful.

This might reach a point where they might develop a consciensce of their own.

As a consequence, they might turn evil and try to kill us all ........... [[201710282118]]

Now if you put your cursor inside the [[201710282118]] link and press [ctrl]+[.], the text will change into this:

# The rise of the machines
tags = #AI #world-domination

Machines are becoming more and more intelligent and powerful.

This might reach a point where they might develop a consciensce of their own.

As a consequence, they might turn evil and try to kill us all ........... [[201710282118]]

<!-- !    [[201710282118]] AI is going to kill us all    -->
# AI is going to kill us all
tags =

<!-- (End of note 201710282118) -->

(We've never actually written anything into the linked note. Usually there would be lots of text)

Note: To remember [ctrl]+[.]: I wanted to use ... as shortcut for expansion but it didn't work out 😄

Hint: If, after expansion, you don't like what you see, just undo! 😄

Note: Use this at your own risk when ever planning on refreshing an overview note. You are going to have nested expansions and precisely those will get overwritten when the parent note is refreshed.

Inline expansion of #tags

Another workflow for producing overview notes is by #tag. So if you want to produce an overview note referencing all notes tagged by a single tag, just press [ctrl]+[.] while the cursor is inside a #tag. This will produce a bulleted list of notes tagged with the #tag.

The following animation shows inline expansion of #tags in action:

Inline expansion of citekeys

In order to produce an outline of all notes citing a specific source, just press [ctrl]+[.] while the cursor is inside a citekey. This will produce a bulleted list of notes containing a reference to the citekey.

Note: This works with @pandoc and #multimarkdown style citation keys and is independent of whether the citekey is part of an actual citation ([@citekey] or [][#citekey]) or just occurs in your text as @citekey or #citekey.

The following animation shows inline expansion of citekeys in action:

Working with Bibliographies

Inserting a citation

If your note archive contains one or you configured a .bib file, then you can use the shortcut [@ or [# to insert a citation. Which one you use depends on your preferences, whether your prefer pandoc or multimarkdown.

A fuzzy-searchable list of all entries in your bibfile will pop up, containing authors, year, title, and citekey. To select the entry you like, just press [enter]. To exit without selecting anything, press [esc].

When you made your choice, a citation link will be inserted into the text: [@citekey] (or [][#citekey] if you use MultiMarkdown style).

The following animation shows this in action:

Note

Your .bib file is loaded the first time you insert a citation
Strings in the .bib file are being converted to unicode so umlauts and special characters can be displayed in the fuzzy panel
This conversion can take long
To disable the conversion and live with u instead of ü, set the setting "convert_bibtex_to_unicode" to false.
To re-load your .bib file, use the menu Tools > Reload BIB file or press ctrl/cmd + shift + B

Automatic Bibliographies

It is common practice to keep local bibliographies in your notes. This makes each note self-contained and independent of .bib files. Manually maintaining a list of all your cited sources can be tedious and error-prone, especially in the case of long notes with many citations. Provided a .bib file is part of your note archive or you have configured one, then this app can take care of all your citations for you.

Note: This will only work if you have pandoc and its companion pandoc-citeproc installed in a location that is referenced by your PATH environment variable! See the how to install pandoc, it's a breeze.

In any note with citations

pick Insert Bibliography from the edit menu
press Control + B

This will add a long comment to your note in the following format (line wrapping added for github manually):

<!-- references (auto)

[@AhrensHowTakeSmart2017]: Ahrens, Sönke. 2017. _How to Take Smart Notes: One Simple Technique
to Boost Writing, Learning and Thinking for Students, Academics and Nonfiction Book Writers_. 1st ed.
CreateSpace Independent Publishing Platform.

[@FastZettelkastenmethodeKontrollieredein2015]: Fast, Sascha, and Christian Tietze. 2015.
_Die Zettelkastenmethode: Kontrolliere dein Wissen_. CreateSpace Independent Publishing Platform.

-->

The animation below shows how handy this is 😄

Note: You don't have to cite in the [@pandoc] notation. If a cite-key is in your text, it will get picked up. However, the generated references section will use the [@pandoc] notation, except if you set change the setting citations-mmd-style to true, then the [#citekey]: ... MultiMarkdown notation will be used.

WARNING: Do not write below the generated bibliography. Everything after <!-- references (auto) will be replaced when you re-run the command!

Searching for notes referencing a specific citekey

In order to be able to search for all notes citing the same source, just like note-links and #tags, citation keys can also be "followed" by clicking them.

Section Numbering and Table Of Contents

This app lets you pep up your texts with automatically numbered sections and tables of content.

Automatic Table Of Contents

Some notes can get quite long, especially when turning overview notes into growing documents. At some stage it might make sense to introduce a table of contents into the text. This can be useful when using some Markdown Preview app to quickly check your text in a browser.

To insert a table of contents at your current cursor position:

from the edit menu select Insert Table of Contents
press Control + Shift + T

The table of contents will be placed between two automatically generated comments that also serve as markers for the app. It will consist of a bulleted list consisting of links to the headings in your text. The links are only relevant when converting your text into HTML.

Why a bulleted list and not a numbered one? You might have numbered the sections yourself. Numbered lists would get in the way in that case. Also, numbered lists produce ii. instead of 1.2 when nesting them.

Example before TOC:

# 201711250024 Working with tocs
tags = #sublime_zk #toc


## This is a very long note!
At least we pretend so.

## It contains many headings
That's why we are going to need a table of contents.

### **with funny chäråcters!**
Funny characters can be a challenge in the `(#references)`.

## as can duplicate headings

# as can duplicate headings
.

Example after TOC:

# 201711250024 Working with tocs
tags = #sublime_zk #toc

<!-- table of contents (auto) -->
* [201711250024 Working with tocs](#201711250024-working-with-tocs)
    * [This is a very long note!](#this-is-a-very-long-note)
    * [It contains many headings](#it-contains-many-headings)
        * [**with funny chäråcters!**](#with-funny-characters)
    * [as can duplicate headings](#as-can-duplicate-headings)
* [as can duplicate headings](#as-can-duplicate-headings_1)
<!-- (end of auto-toc) -->

## This is a very long note!
At least we pretend so.

## It contains many headings
That's why we are going to need a table of contents.

### **with funny chäråcters!**
Funny characters can be a challenge in the `(#references)`.

## as can duplicate headings

# as can duplicate headings
.

Note: Whenever you need to refresh the table of contents, just repeat the above command.

Note: You can configure the separator used to append a numerical suffix for making references to duplicate headers distinct: by changing the toc_suffix_separator in the settings. It is set to an underscore by default (markdown preview, parsers based on Python's markdown module). If you use pandoc, you should set it to -.

The following animation shows TOC insertion and refreshing in action:

Automatic Section Numbering

Especially when your text is large enough for needing a table of contents, it is a good idea to number your sections. This can be done automatically as follows:

from the edit menu select Insert Section Numbers
press Control + Shift + N

Automatically inserted section numbers will look like in the following note:

# 1  201711250024 Working with tocs
tags = #sublime_zk #toc


## 1.1  This is a very long note!
At least we pretend so.

## 1.2  It contains many headings
That's why we are going to need a table of contents.

### 1.2.1  **with funny chäråcters!**
Funny characters can be a challenge in the `(#references)`.

## 1.3  as can duplicate headers

# 2  as can duplicate headers
.

Note:

You can refresh the section numbers at any time by repeating the above command.
To switch off numbered sections, use the command Remove Section Numbers from the edit menu.
The setting "skip_first_heading_when_numbering": true will skip the first heading of your note and not assign it a number. This can be useful if your first heading is the note title.

The animation below shows both section (re-)numbering and auto-TOC:

Saved Searches

The bottom right editor shows a saved searches file. This is a simple Text file where you can name and store search terms.

Note: This file is saved automatically each time a note is saved. If you manually want to save it, just press ctrl/cmd+S while the text cursor is in the saved searches editor.

The syntax is very simple; to define a search, you just add a line, consisting of the following parts:

an optional search name
a colon :, followed by either
- a search-spec (see advanced tag search for more information)
  - #! (all tags) and [! (all notes) are also valid search-specs
- or, instead of a tag search, any search term you want to search for in find_in_files fashion.

The search-spec will be highlighted in the file, so you know exactly what will be searched for.

You can place Markdown headings anywhere in the file, too, like this:

# Shortcuts
All Notes    :    [!
All Tags     :    #!

# Tag Searches
just one  tag:          #tag
tag1 or  tag2:          #tag1  #tag2
tag1 and tag2:          #tag1, #tag2

# A bit more complex
tag1 but not tag2:                 #tag1, !#tag2
tag1 or anything that's not tag2 : #tag1 !#tag2

# Wildcard searches
anything starting with auto : #auto*
anything starting with auto but nothing starting with plane: #auto*, !#plane*

You can execute the search by clicking on the underlined search spec.

Advanced Saved Searches

You can specify how the results of saved searches should be sorted by adding a string following the syntax of {sortby: id|title|mtime|refcount, order: asc|desc} at the end of a saved search:

sortby
- id : sort by note-id
- title : sort by note title
- mtime : sort by modification time (when the note was last saved or created)
- refcount : this only applies to the refcounts() function, see below
- history : this only applies to the view_history() function, also described here.
order
- asc : ascending from low to high
- desc : descending from high to low

The following is an example to show all notes, sorted by last modification time, the most recently edited notes:

Recent notes    : [!  {sortby: mtime,    order: desc}

Reference Counts : Find un-referenced and most-referenced notes

Saved searches also support functions, prefixed by an equal sign. Currently the only function is =refcounts(), for searching for notes that are referenced (linked to) a certain number of times. It supports two paramenters min and max, holding the minimum and maximum number of references, accordingly.

Here are some examples:

unreferenced    : =refcounts(min:0, max:0) {sortby: mtime}

most-referenced : =refcounts(min:1, max:1000) {sortby: refcount, order: desc}

The unreferenced search lists all notes that are not referenced (linked to) by any other note: max: 0.

The most-referenced search lists all notes which are linked to at least once and sorts them by reference count (number of notes that link to it): {sortby: refcount, order: desc}.

Note: sorting by refcount is only applicable to the refcount() function. It has no effect on other searches.

Note History

There is a simple function that doesn't take any parameters and produces the search results you know from Browsing recently opened notes.

It only has one valid syntax: =view_history(){sortby: history}.

In the default saved searches it is usually put like this:

View History       :    =view_history(){sortby: history}

HTML Export

You can export your note archive, or parts thereof, into a semantic text view, consisting of one big HTML file and optional images:

In the file menu, choose "Export archive to HTML..."
Click on the "..." button to select a destination folder
Optionally add a base URL if you plan to upload to a web server later (to get the links to images right)
- e.g. https://my.server.com/folder
- do this only if you really want to upload to a server.
- For checking the generated HTML locally, leave that field blank
Optionally specify start and end date ranges
- e.g. 2018, or 20180429
Optionally specify tags notes must be tagged with
Optionally specify tags notes must not be tagged with
Choose one of the available parsers
Click "Convert!"

The resulting semantic text view features:

Browsing
- Notes by title
- tags: see what notes are tagged with a certain #tag
- cite keys: see what notes cite a specific source
Notes
- show your notes
- show clickable #tags the note contains
- show links to expand into linked notes, for each paragraph that contains links.
- show links to cite keys that expand into the citation's source and also a list of links to notes that also cite that source
- show fenced code blocks with syntax-coloring
- show local images, automatically scaled
tags
- Are displayed in the #tags overview but also inside each note
- Clicking on a #tag expands it into a list of tagged notes
cite keys
- Are displayed in the @citations overview but also after each paragraph that contains citations.
- Clicking on a cite key shows the citation's source and also a list of links to notes that also cite that source

Here is what it looks like when clicking on a demo note:

On Linux, unfortunately there is no HTML preview, but an "open in browser" button:

About the available parsers

There are 3 different markdown parsers available:

basic: the fastest but least capable parser
- handles pandoc and multimarkdown citations
- handles pandoc and multimarkdown style fenced code blocks with syntax coloring
- no tables
- supports images
multimarkdown (default): fast parser, should always be used
- handles pandoc and multimarkdown citations
- handles pandoc and multimarkdown style fenced code blocks with syntax coloring
- handles multimarkdown tables
- supports images
pandoc: slow parser but can handle pandoc markdown
- handles pandoc and multimarkdown citations
- handles pandoc and multimarkdown style fenced code blocks with syntax coloring
- handles multimarkdown tables
- handles pandoc tables
- supports images

You should always use the default mmd parser, even if your text uses pandoc syntax.

The only exception is: If your text contains pandoc style tables, then go for the pandoc parser. Pandoc [@citations] and pandoc ~~~fenced cod blocks~~~ will be converted internally automatically by the tool, so that the multimarkdown parser can handle them.

Customizing Themes

Themes are simple JSON files that define

the font
styles
colors

of the Markdown editor.

Creating a new Theme

To create a new theme, run View > Create new Theme ... from the menu. You will be prompted for a name and upon entering it:

a copy of your currently active theme will be made your new theme
a json editor opens where you can modify your new theme

When you File > Save (ctrl/cmd + S) the file, your new theme is ready. You can switch to it via View > Switch Theme.

Editing Themes

When you create a new theme or when you run View > Edit current theme, a JSON editor opens so you can modify the theme.

The following types are used in the description:

type	description
font	has 3 fields: "face" = name of the font, "size" = font-size, "style" = style of the font
pixels	a number of pixels
color	HTML color code
color with alpha	HTML color code with alpha prefix (1F in #1F333333)
style	one of "normal", "bold", "italic", and "bolditalic"
text-type	has a "face" and "size" field to define font-face and font-size, has a "color" field of type color, a "style" field of type style, and a "background" field of type color for the background color of the text
markup	has a "symbol" field of type text-type for the markup symbol (`#` for headings, `*` or `_` for italic, ...), and a "text" field for styling the marked-up text

The following fields define the appearance of the markdown editor:

key	type	description
background	color	background color
foreground	color	default text color
linehighlight	color with alpha	color and alpha (1F in #1F333333) for highlighting the current line
line_padding_top	pixels	number of pixels to pad the top of lines with (extra line height)
line_padding_bottom	pixels	number of pixels to pad the bottom of lines with (extra line height)
selection	colors with alpha	"background" defines the background and foreground the text color of selected text
font	font	"face" = name of the font, "size" = font-size, "style" = style of the font
caret	color	color of the cursor
text.italic	markup	defines how `_italic_` text is displayed
text.bold	markup	defines how `bold` text is displayed
text.bolditalic	markup	defines how `*bolditalic*` text is displayed
h.symbol	text-type	defines how the markup symbol `#` is styled in headings
h1.text	text-type	defines how the text of `# h1 headings` is styled
h2.text	text-type	defines how the text of `## h2 headings` is styled
h3.text	text-type	defines how the text of `### h3 headings` is styled
h4.text	text-type	defines how the text of `#### h4 headings` is styled
h5.text	text-type	defines how the text of `##### h5 headings` is styled
h6.text	text-type	defines how the text of `###### h6 headings` is styled
quote	markup	defines how `> quotes` are styled
code.fenced	markup	defines how ```code blocks are styled
code	markup	defines how `indented code` and `inline code` is styled
list.symbol	text-type	the style of the `*`, `-`, and `1.` symbols in lists
list.unordered	text-type	the style of the text of unordered `*` or `-` lists
list.ordered	text-type	the style of the text of ordered `1.`, `2.`, ... lists
tag	text-type	the style of `#tags`
citekey	text-type	the style of `@citekeys` or `#citekeys` inside `[@citekey]` or `[][#citekey]` citations
link	text-types	has 3 fields "title", "url", and "attr" for styling `[title](url){optional-attributes}` links
zettel.link	text-type	style of `[[201804300800]]` note links
comment	text-type	style of `<!-- comments -->`
footnote	text-type	style of `^text` inside a `[^footnote]` footnote

Note: On save, the editor will display an error message if your JSON contains errors. The error message will contain a short description including the line and column number of the first character where the error occured. The cursor will be set at exactly that position so you can figure out more easily what is incorrect. Syntax-coloring should also help you formatting the theme file.

External Commands

You can run external commands, for instance, to create a PDF or HTML from your current note; there are several ways to invoke an external command:

Use the Tool Menu > Run External Command...
Use the command palette: "Run External Command..."
Press ctrl/cmd + shift + X
Use the command palette and enter >
- All external commands are integrated into the command palette
- They are prefixed with the > symbol

Pre-configured are example commands for creating and opening PDF files from notes:

PDF [no-bibfile] (pandoc) : Uses pandoc (and pdflatex) to convert a note to PDF
PDF (pandoc) : Uses pandoc (and pdflatex) to convert a note to PDF, including citations and references
- if you don't have a .bib file or if you cite sources not contained in your .bib file, this will not work

The following animation shows this in action, using the command palette to select the command PDF [no-bibfile] (pandoc):

Writing your own external commands

Let's do this by example. The following is the snippet for PDF conversion that you just saw above:

    // convert to PDF via pandoc
    "PDF [no-bibfile] (pandoc)" : {
        "run": [
            "pandoc",  "{note_path}{note_name}{note_ext}",
            "-f", "markdown",
            "--output={tempfile}.pdf",
            "--toc",    // create a table of contents
            "--smart",
            "--normalize",
            "--highlight-style=tango"
        ],
        "on_finish": {
            "open": "{tempfile}.pdf",
            "reload_note": false,
            "open_new_note": false
        },
        "on_error": {
            "show_error": true
        }
    },

You can edit this with the external commands editor, which you can open with the "Edit external commands" action from the command palette or the Tools menu.

Each command has a name and consists of 3 sections:

"run" : here comes a list of the program name, followed by optional arguments
"on_finish"
- "open": lets you auto-open a result file
- "reload_note": if true, reloads the current note, assuming your command has modified it
- "open_new_note": if true, opens the new note that the external command has created
"on_error": if "show_error" is true, which it should always be, then an error message will be shown if the command terminates with a non-zero exit code (the universal convention for error conditions).

Using variables

But how to tell the name of the result file to open or the note ID of a new note that should be created by the external command?

Here come the variables! Use them inside the "run" and the "open" sections:

variable	description
`{note_path}`	path to the note
`{note_name}`	filename of the note without extension!
`{note_ext}`	extension of the note file
`{bib}`	full path to .bib file if present, else None
`{tempfile}`	full path to a temporary file you can write to
`{new_note_id}`	a timestamp based note id if you need to create a new note

Note: Based on the above, to pass the complete filename of the current note to your external command, use: {note_path}{note_name}{note_ext}.

Configuration

Files

The Settings File

You can edit all settings by opening the settings file:

Windows: Use the menu: Edit > Settings
macOS:
- press Command + ,
- alternatively use the menu: sublimeless_zk > Preferences...

Note: You need to save the settings after you changed them.

Note: Some changes only take effect after restarting the app: color scheme, for instance.

The settings file is just a text file an can be edited like any other text file. Here is an excerpt from the default settings:

Note: All lines starting with // are just comments.

{
    // Theme:
    //    themes/monokai.json
    //    themes/solarized_light.json
    "theme": "themes/monokai.json",

    // The preferred markdown extension
    "markdown_extension": ".md",

We will go into further details later, but here is a quick reference of all currently supported settings:

setting	default	remarks
"theme"	"themes/Office.json"	Theme for the note editor. Alternative theme: "themes/solarized_light.json"
"markdown_extension"	".md"	Extension of your note files.
"new_note_template"	`"# {id} {title}\n<!-- tags: -->"`	Template for new notes. Fields in `{curly braces}` will be substituted.
"double_brackets"	true	Insert links with [[double brackets]] (true) or [single brackets] (false)
"insert_links_with_titles"	false	insert note title after inserted link
"id_in_title"	false	New notes title will contain the note id (true) or not (false)
"tag_prefix"	"#"	Prefix character(s) for tags.
"path_to_pandoc"	"/usr/local/bin/pandoc"	Explicit location of the pandoc program. Only needed for auto-bib, and if pandoc can't be found automatically.
"bibfile"	"/path/to/zotero.bib"	bibliography file to use if none is contained in the notes folder
"convert_bibtex_to_unicode"	true	convert bibtex strings to unicode for showing umlauts etc. Set this to false if loading your .bib file takes ages
"toc_suffix_separator"	"_"	suffix separator for distinguishing links to identically named sections in table of contents. If you plan to use pandoc for HTML conversion, set this to "-"
"citations-mmd-style"	false	`[@citekey]` pandoc notation (false) or `[][#citekey]` multimarkdown notation for inserted citations
"seconds_in_id"	true	Long YYYYMMDDHHMMSS timestamp IDs containing seconds (true = default) or YYYYMMDDHHMM IDs (false)
"sort_notelists_by"	"id"	in search-results, search by note "id" or note "title"
"auto_save_interval"	60	auto-save unsaved notes every n seconds. 0 to disable
"skip_first_heading_when_numbering"	false	exclude first heading when auto-numbering sections
"wrap_lines"	true	wrap lines or rather scroll horizontally
"show_wrap_markers"	true	show markers at the end of wrapping lines
"indent_wrapped_lines"	false	should wrapping lines be indented even further
"auto_indent"	true	automatically indent next line when pressing return
"show_indentation_guides"	true	show guides for indented lines
"use_tabs"	false	use tabs instead of 4 spaces when pressing the `TAB` key

Markdown filename extension

By default, the extension .md is used for your notes. If that does not match your style, you can change it with the markdown_extension setting. Just replace .md with .txt or .mdown or whatever you like.

Auto-Save Interval

The setting auto_save_interval specifies the interval in seconds, at which unsaved notes will be saved automatically. Set this to 0 to disable auto-save.

User-Interface Fonts

To change the appearance of the user interface, experiment with the following settings:

    "ui.font.face": "Arial",
    "ui.font.size": 14,
    "ui.tabs.font.face": "Arial",
    "ui.tabs.font.size": 14,
    "ui.statusbar.font.face": "Arial",
    "ui.statusbar.font.size": 14,
    "ui.editorinfo.font.face": "Arial",
    "ui.editorinfo.font.size": 14,

These settings are not in the settings file by default.

Notes and Links

Single or double brackets

Whether you want to use [[this link style]] or [that link style] is totally up to you. Both work. But you need to configure which style you prefer, so automatically inserted links will match your style. [[double bracket]] links are the default, and if you want to change that to single bracket links, set the double_brackets parameter to false in the settings file.

Note ID precision

The default note ID format is a timestamp in YYYYMMDDHHMMSS format, with second-precision. If you tend to create more than one note per minute, this is what you want. If you prefer shorter note-IDs, you can change the note ID format to YYYYMMDDHHMM, with minute-precision.

The following setting influences the note ID format:

    // seconds in note IDs?
    // if true : YYYYMMDDHHMMSS 20171224183045
    // if false: YYYYMMDDHHMM   201712241830
    "seconds_in_id": true,

Insert links with or without titles

There are numerous times where the app inserts a [[link]] to a note into your text on your behalf. You may not only choose the single or double-bracketness of the links, you may also choose whether the note title should follow the inserted link.

The setting "insert_links_with_titles" takes care of that and is set to false by default:

// links like "[[199901012359]] and note title" instead of "[[199901012359]]"
"insert_links_with_titles": false,

Examples how inserted links might look like depending on this setting:

`insert_links_with_titles` is `true`:
[[199901012359]] and note title


`insert_links_with_titles` is `false`:
[[199901012359]]

IDs in titles of new notes

When you create a new note, its title will automatically be inserted and an ID will be assigned to it (see Creating a new note). If you want the ID to be part of the title, change the setting id_in_title from false to true.

Example for a note created with ID:

# 201710310128 This is a note with its ID in the title
tags=

The setting id_in_title is set to true.

Example for a note created without ID:

# A note without an ID
tags =

The setting id_in_title is set to false.

New Note templates

If you need further customizing of how your new notes should look like, you can define your own template:

In the settings just edit the new_note_template like this:

  "new_note_template": "---\nuid: {id}\ntags: \n---\n",

To produce new notes like this:

---
uid: 201711150402
tags:
---

The format string works like this:

\n creates a new line.
{id} : the note id like 201712241830
{title} : note title like Why we should celebrate Christmas
{origin_id} : the id of the note you came from when creating a new note
{origin_title} : the title of the note you came from when creating a new note
{file} : the filename of the note like 201712241830 Why we should celebrate Christmas.md
{path} : the path of the note like /home/reschal/Dropbox/Zettelkasten
{timestamp: format-string}: the date timestamp formatted by format-string, see [below]

origin might need a bit of explanation: When you are in note 201701010101 and create a new note via [shift]+[enter] or via [[implicit note creation via title]], the new note will get a new id, maybe 201702020202. Its {id} therefore will be 201702020202 and its {origin} will be 201701010101.

Date and time formatting options for timestamp

Directive	Meaning	Example
`%a`	Weekday as locale’s abbreviated name.	Sun, Mon, …, Sat (en_US); So, Mo, …, Sa (de_DE)
`%A`	Weekday as locale’s full name.	Sunday, Monday, …, Saturday (en_US); Sonntag, Montag, …, Samstag (de_DE)
`%d`	Day of the month as a zero-padded decimal number.	01, 02, …, 31
`%b`	Month as locale’s abbreviated name.	Jan, Feb, …, Dec (en_US); Jan, Feb, …, Dez (de_DE)
`%B`	Month as locale’s full name.	January, February, …, December (en_US); Januar, Februar, …, Dezember (de_DE)
`%m`	Month as a zero-padded decimal number.	01, 02, …, 12
`%y`	Year without century as a zero-padded decimal number.	00, 01, …, 99
`%Y`	Year with century as a decimal number.	2017, 2018, …
`%H`	Hour (24-hour clock) as a zero-padded decimal number.	00, 01, …, 23
`%I`	Hour (12-hour clock) as a zero-padded decimal number.	00, 01, …, 12
`%p`	Locale’s equivalent of either AM or PM.	AM, PM (en_US); am, pm (de_DE)
`%M`	Minute as a zero-padded decimal number.	01, 02, …, 59
`%S`	Second as a zero-padded decimal number.	01, 02, …, 59
`%j`	Day of the year as a zero-padded decimal number.	001, 002, …, 366
`%U`	Week number of the year (Sunday as the first day of the week) as a zero padded decimal number. All days in a new year preceding the first Sunday are considered to be in week 0.	00, 01, …, 53
`%W`	Week number of the year (Monday as the first day of the week) as a zero padded decimal number. All days in a new year preceding the first Monday are considered to be in week 0.	00, 01, …, 53
`%c`	Locale’s appropriate date and time representation.	Tue Aug 16 21:30:00 1988 (en_US); Di 16 Aug 21:30:00 1988 (de_DE)
`%c`	Locale’s appropriate date representation.	08/16/88 (None); 08/16/1988 (en_US); 16.08.1988 (de_DE)
`%%`	A literal `%` character.	%

Examples for note id 201802261632:

{timestamp: %Y-%m-%d %H:%M}: 2018-02-26 16:32
{timestamp: %a, %b %d, %Y}: Mon, Feb 26, 2018

Example YAML note header

To produce a YAML note header (for pandoc), like this:

---
note-id: 201802270019
title:  Date Test
author: First Last
date: 2018-02-27
tags:
---

you can use the following settings:

// when creating a new note, put id into title?
 // false to disable
"id_in_title": false,

// Template for new notes
"new_note_template":
    "---\nnote-id: {id}\ntitle: {title}\nauthor: First Last\ndate: {timestamp: %Y-%m-%d}\ntags: \n---\n",

Bibliographies and Citations

Location of your .bib file

If you work with bibliographies, this app can make use of your .bib files to enable insertion of @citekeys (or #citekeys if you use MultiMarkdown) and automatic creation of bibliographies inside of your notes.

Note: If a .bib file resides in your note archive folder then the app will find it automatically. No configuration needed!

Hint: If you happen to work with multiple note archives, each requiring its own .bib file, it makes sense to make the .bib files part of their corresponding note archives.

However, if you maintain your .bib file outside of your note archive, then you can configure its location in the settings; just add a line like this:

    "bibfile": "/path/to/zotero.bib",

In cases where both a bibfile setting is present and an actual .bib file is found in your note archive, the one in the note archive will be used.