{"id":13512270,"url":"https://github.com/renerocksai/sublime_zk","last_synced_at":"2025-04-05T10:09:08.638Z","repository":{"id":40643695,"uuid":"108672262","full_name":"renerocksai/sublime_zk","owner":"renerocksai","description":"A SublimeText3 package featuring ID based wiki style links, and #tags, intended for zettelkasten method users. Loaded with tons of features like inline image display, sophisticated tag search, note transclusion features, support for note templates, bibliography support, support for multiple panes, etc. to make working in your Zettelkasten a joy :smile:.","archived":false,"fork":false,"pushed_at":"2021-08-30T10:07:34.000Z","size":2008,"stargazers_count":508,"open_issues_count":45,"forks_count":59,"subscribers_count":24,"default_branch":"master","last_synced_at":"2025-03-29T09:11:38.537Z","etag":null,"topics":["markdown","sublime-package","sublime-text","sublime-text-3","zettelkasten"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/renerocksai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-10-28T18:06:41.000Z","updated_at":"2025-03-12T02:02:16.000Z","dependencies_parsed_at":"2022-08-28T02:53:38.492Z","dependency_job_id":null,"html_url":"https://github.com/renerocksai/sublime_zk","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/renerocksai%2Fsublime_zk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/renerocksai%2Fsublime_zk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/renerocksai%2Fsublime_zk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/renerocksai%2Fsublime_zk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/renerocksai","download_url":"https://codeload.github.com/renerocksai/sublime_zk/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247318745,"owners_count":20919484,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["markdown","sublime-package","sublime-text","sublime-text-3","zettelkasten"],"created_at":"2024-08-01T03:01:40.063Z","updated_at":"2025-04-05T10:09:08.621Z","avatar_url":"https://github.com/renerocksai.png","language":"Python","funding_links":[],"categories":["Python","Software","Uncategorized"],"sub_categories":["Uncategorized"],"readme":"# Sublime ZK\n\nThis is a plugin for SublimeText3 to enable ID-based, Wiki-style links, and #tags in your documents.\n\nIf you follow the (plain-text) Zettelkasten method (as proposed by [Zettelkasten.de](https://zettelkasten.de) or [takesmartnotes.com](http://takesmartnotes.com/#moreinfo)), this might appeal to you.\n\nIn short, it helps you manage an archive of interlinked notes that look like this:\n\n![screenshot](https://user-images.githubusercontent.com/30892199/32403197-25d9ccd2-c134-11e7-93c6-62257f35e518.png)\n\nSee the [Usage](#usage) section below to see how this package might support your workflow.\n\n## Features\n*(This package is still in active development. If you like, stay up to date with latest developments at: [Its dedicated Zettelkasten.de Forum Thread](https://forum.zettelkasten.de/discussion/77/renes-sublimetext-for-zettelkasten-package-talk-and-more#latest))*\n\n* This plugin enables you to place wiki style links like `[[this]]` or `[this]` (and old-school links like this `§201711111709`) into your notes to link to other notes in your note archive.\n* Clicking such a link and pressing `[ctrl]+[enter]` will open the corresponding note.\n* Alternatively, double-clicking the link while holding the `[alt]` key down, will also open the corresponding note.\n* Clicking such a link and pressing `[alt]+[enter]` will search for all notes also referencing the linked note [('friend notes')](#searching-for-friends).\n* Typing `[[` will open a list of existing notes so you can quickly link to existing notes.\n* Typing `[ctrl]+[space]` (or `[alt]+[/]` on Linux) will trigger note-link auto-completion for even quicker insertion of links to other notes.\n* Typing `[shift]+[enter]` lets you enter a name for a new note. The new note is then created with a new note ID.\n* Implicit note creation via links to non-existing notes' titles, see [below](#implicitly-creating-a-new-note-via-a-link).\n* The ID format is timestamp-based YYYYMMDDHHMM - eg: 201710282111, but can be switched second-precision YYYYMMDDHHMMSS - eg: 20171224183045\n* Highlighting of note links\n* Highlighting of #tags\n* Highlighting of footnote references `[^like this one]` and `[ref. @pandoc]` references.\n* Typing `[#][!]` will create a scratch file containing all your **#tags**, sorted\n* `[#][?]` opens up a list of all your **#tags** and lets you fuzzy search and select them (like note-links).\n* Clicking a **#tag** or citekey and pressing `[ctrl]+[enter]` will search for all notes containing this tag / citekey.\n* Alternatively `[alt]` + double clicking the tag/citekey will do the same thing.\n* Support for `ag`, [The Silver Searcher](#installing-the-silver-searcher)\n* [Expansion of overview notes with selective refresh](#expansion-of-overview-notes-with-selective-refresh)!!!\n* [Templates for new notes](#new-note-templates)\n* [Optional](#insert-links-with-or-without-titles) insertion of `[[links]] WITH note titles` instead of just `[[links]]`\n* Inline expansion of [note links](#inline-expansion-of-note-links), [tags](#inline-expansion-of-tags), and [citekeys](#inline-expansion-of-citekeys) via `[ctrl]+[.]`\n* [Searching for advanced tag combinations](#advanced-tag-search)\n* [Automatic Bibliographies](#automatic-bibliographies), [auto-completion for citekeys](#auto-completion-for-citekeys), and fuzzy-search [insertion of citations](#inserting-a-citation)\n* [Inline Local Image Display](#inline-local-image-display)\n* [Automatic Table Of Contents](#automatic-table-of-contents)\n* [Automatic Section Numbering](#automatic-section-numbering)\n* [Support for Panes](#working-with-panes)\n* **NEW:** [Color Schemes](#monokai-extended-color-scheme)\n* **!!! NEW !!!** [Zettelkasten Mode](#zettelkasten-mode)\n\n## Contents\n* [Installation](#installation)\n    * [Automatic Installation \u0026 Updates](#automatic-installation--updates)\n    * [Manual Installation](#manual-installation)\n    * [Installing The Silver Searcher](#installing-the-silver-searcher)\n    * [Installing Pandoc](#installing-pandoc)\n* [Configuration](#configuration)\n    * [Zettelkasten note folder](#zettelkasten-note-folder)\n        * [How do I create a project in SublimeText?](#how-do-i-create-a-project-in-sublimetext)\n            * [Automatic approach](#automatic-approach)\n            * [Manual approach](#manual-approach)\n    * [Markdown filename extension](#markdown-filename-extension)\n    * [Single or double brackets](#single-or-double-brackets)\n    * [Note ID precision](#note-id-precision)\n    * [Insert links with or without titles](#insert-links-with-or-without-titles)\n    * [IDs in titles of new notes](#ids-in-titles-of-new-notes)\n    * [New Note templates](#new-note-templates)\n    * [Highlight references to other notes](#highlight-references-to-other-notes)\n    * [Syntax Coloring for #tags, footnotes, and pandoc references](#syntax-coloring-for-tags-footnotes-and-pandoc-references)\n        * [Monokai Extended Color Scheme](#monokai-extended-color-scheme)\n        * [Solarized Color Scheme](#solarized-color-scheme)\n        * [Commodore 64 Color Scheme](#commodore-64-color-scheme)\n        * [Honorable Mention: Zettel Coffee Color Scheme](#honorable-mention-zettel-coffee-color-scheme)\n        * [Rolling your own Color Scheme](#rolling-your-own-color-scheme)\n    * [Configuring SublimeText's line spacing](#configuring-sublimetexts-line-spacing)\n    * [Location of your .bib file](#location-of-your-bib-file)\n    * [Citation Reference Style](#citation-reference-style)\n    * [Inline image preview size](#inline-image-preview-size)\n    * [Auto inline image preview](#auto-inline-image-preview)\n    * [Default panes](#default-panes)\n* [Usage](#usage)\n    * [Shortcut cheatsheet](#shortcut-cheatsheet)\n    * [Creating a new note](#creating-a-new-note)\n    * [Creating a new note and link from selected text](#creating-a-new-note-and-link-from-selected-text)\n    * [Creating a link](#creating-a-link)\n        * [Using auto-completion to insert note-links](#using-auto-completion-to-insert-note-links)\n        * [Implicitly creating a new note via a link](#implicitly-creating-a-new-note-via-a-link)\n        * [Supported link styles](#supported-link-styles)\n    * [Searching for friends](#searching-for-friends)\n    * [Listing all notes](#listing-all-notes)\n    * [Working with tags](#working-with-tags)\n        * [Getting an overview of all your tags](#getting-an-overview-of-all-your-tags)\n        * [Experimental tag selector](#experimental-tag-selector)\n        * [Searching for notes containing specific tags](#searching-for-notes-containing-specific-tags)\n        * [Advanced Tag Search](#advanced-tag-search)\n            * [Grammar and Syntax](#grammar-and-syntax)\n            * [Putting it all together](#putting-it-all-together)\n    * [Expansion of overview notes with selective refresh](#expansion-of-overview-notes-with-selective-refresh)\n        * [Expansion of overview notes](#expansion-of-overview-notes)\n        * [Refreshing an expanded overview note](#refreshing-an-expanded-overview-note)\n        * [Inline expansion of note-links](#inline-expansion-of-note-links)\n    * [Working with Bibliographies](#working-with-bibliographies)\n        * [Inserting a citation](#inserting-a-citation)\n        * [Auto-Completion for citekeys](#auto-completion-for-citekeys)\n        * [Automatic Bibliographies](#automatic-bibliographies)\n        * [Searching for notes referencing a specific citekey](#searching-for-notes-referencing-a-specific-citekey)\n    * [Inline Local Image Display](#inline-local-image-display)\n    * [Section Numbering and Table Of Contents](#section-numbering-and-table-of-contents)\n        * [Automatic Table Of Contents](#automatic-table-of-contents)\n        * [Automatic Section Numbering](#automatic-section-numbering)\n    * [Working with Panes](#working-with-panes)\n    * [The Ultimate Zettelkasten Mode](#zettelkasten-mode)\n* [Credits](#credits)\n\n\n## Installation\n\n### Automatic Installation \u0026 Updates\n\nSublime Text comes with Package Control, a feature which allows you to easily install and update third party packages. You can use it to install this package and keep it up to date:\n\n1. Install [Sublime Text 3](http://www.sublimetext.com/3)\n2. Use the Command Palette (Tools \u003e Command Palette...) and run **Install Package Control**. Sublime Text will alert you when the installation has finished.\n3. Use the Command Palette and run **Package Control: Add Repository**\n4. Add the URL of this repository `https://github.com/renerocksai/sublime_zk` into the panel that appears at the bottom of the window and press `Enter`.\n5. Use the Command Palette and run **Package Control: Install Package** and search for `sublime_zk` from the list of available packages. Select it and press `Enter` to install the package.\n6. You can keep your packages up to date by running **Package Control: Upgrade Package** from the Command Palette.\n\n**Note:** If you're on _macOS_ and have troubles installing through package control as described above, please see [this issue](https://github.com/renerocksai/sublime_zk/issues/50#issuecomment-377724551) for a fix.\n\n**Note**: I'm still awaiting a go from package control. Once this has gone through, you will be able to use package control like this:\n\n\u003e 1. Install [Sublime Text 3](http://www.sublimetext.com/3)\n\u003e 2. Use the Command Palette (Tools \u003e Command Palette...) and run **Install Package Control**. Sublime Text will alert you when the installation has finished.\n\u003e 3. Use the Command Palette and run **Package Control: Install Package** and search for `Zettelkasten - sublime_zk` from the list of available packages. Select it and press `Enter` to install the package.\n\u003e 4. You can keep your packages up to date by running **Package Control: Upgrade Package** from the Command Palette.\n\n\n\n### Manual Installation\n\nThe following steps cover all dependencies and prerequisites. Skip the steps you don't need:\n\n1. Install [Sublime Text 3](http://www.sublimetext.com/3)\n2. Download the sublime_zk zip from [this repo](https://github.com/renerocksai/sublime_zk).\n3. Unzip the sublime_zk plugin. You should get a `sublime_zk` folder.\n4. Under Preferences, go to 'Browse Packages...'. This opens the package location of SublimeText in your file browser.\n5. Copy the `sublime_zk` folder into the package location folder from the previous step.\n\nYou should be all set.\n\n### Installing The Silver Searcher\n\nThis plugin can make use of `ag`, [The Silver Searcher](https://github.com/ggreer/the_silver_searcher), to **dramatically speed up** and improve the [search for all tags](#getting-an-overview-of-all-your-tags), the [tag selector](#experimental-tag-selector), [tagged notes search](#searching-for-notes-containing-specific-tags), and [friend note search](#searching-for-friends) features. According to its [Installation Instructions](https://github.com/ggreer/the_silver_searcher#installing), it is fairly easy to install on macOS, Linux, BSD and Windows:\n\n- [macOS installation](https://github.com/ggreer/the_silver_searcher#macos)\n- [Linux installation](https://github.com/ggreer/the_silver_searcher#linux)\n- [BSD installation](https://github.com/ggreer/the_silver_searcher#bsd)\n- [Windows installation](https://github.com/ggreer/the_silver_searcher#windows)\n  - Alternate Windows installation using [Chocolatey](https://chocolatey.org/): `choco install ag`\n  - Alternate Windows installation using [Scoop](http://scoop.sh/): `scoop install ag`\n  - Note: If you use the [Unofficial daily builds](https://github.com/k-takata/the_silver_searcher-win32) make sure when you download them, to put them into a folder referenced by your PATH environment variable so they can be found by the plugin.\n\n**Note:** You **really want** to install _The Silver Searcher_. It makes this plugin much more useful. If `ag` is present, the plugin makes use of a permanent search results file that gets updated with the results of searches for tags, referencing notes, the tag list, etc. This really shines when [searching for tagged notes](#searching-for-notes-containing-specific-tags) and [searching for friend notes](#searching-for-friends).\n\nThe permanent search results file is like a navigation-window and is especially useful when using a non-single layout, like in this screenshot:\n\n![silver-tags](https://user-images.githubusercontent.com/30892199/32641877-b27b28fc-c5d0-11e7-89ac-20f1f83db586.png)\n\n### Installing Pandoc\n\nWhether you use [Pandoc](https://pandoc.org) or not for Markdown processing, the [AutoBib](#automatic-bibliographies) feature requires it. Luckily it is [easy to install](https://pandoc.org/installing.html).\n\n## Configuration\n\n\n### Zettelkasten note folder\nNo further configuration is necessary. This Zettelkasten plugin works with SublimeText projects. It will use exactly the same directory where your SublimeText project file is located.\n\n#### How do I create a project in SublimeText?\nThat's easier than it might look. This is how I do it:\n\n##### Automatic approach\nJust start working and [create a new note](#creating-a-new-note)! In an empty SublimeText window with no project or file open:\n\n* bring up the command palette by pressing `[cmd]+[shift]+[p]` on macOS (`[ctrl]+[shift]+[p]` on Windows and Linux).\n* type `zk` to list the *Zettelkasten* commands.\n* select `ZK: New Zettel Note`\n\nAfter entering the note's title, SublimeText will ask you where to save your new note and its corresponding project file. From then on, you'll be working in the very project directory that you just selected or created.\n\n**Note:** Once your Zettelkasten project is created, you can use the shortcut `[shift]+[enter]` to create new notes.\n\n##### Manual approach\nIf you want to create an empty project first and then start creating notes or if you want to create a project for a folder that already contains notes, here is what I would do:\n\n* Start with a fresh SublimeText window (containing no open files or projects).\n* Use the menu: \"Projects\" -\u003e \"Save Project As ...\" and save this empty project into your desired Zettelkasten folder, giving the project file a name other than untitled if you like.\n* Now add the Zettelkasten folder to your project: \"Project\" -\u003e \"Add Folder To Project...\" and select your Zettelkasten folder.\n* Done! :-)\n\n\n### Markdown filename extension\nBy default, the extension `.md` is used for your notes. If that does not match your style, you can change it in the `sublime_zk.sublime-settings` file. Just replace `.md` with `.txt` or `.mdown` or whatever you like.\n\n### Single or double brackets\nWhether 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 `sublime_zk.sublime-settings`.\n\n### Note ID precision\n\nThe default note ID format is a timestamp in `YYYYMMDDHHMM` format, with minute precision. If you tend to create more than one note per minute, this can be a problem. In that case, you can change the note ID format to `YYYYMMDDHHMMSS`, with second-precision.\n\nThe following setting influences the note ID format:\n\n```json\n    // seconds in note IDs?\n    // if true : YYYYMMDDHHMMSS 20171224183045\n    // if false: YYYYMMDDHHMM   201712241830\n    \"seconds_in_id\": true,\n```\n\n### Insert links with or without titles\nThere are numerous times where the plugin 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.\n\nThe setting `\"insert_links_with_titles\"` takes care of that and is set to `false` by default:\n\n```\n// links like \"[[199901012359]] and note title\" instead of \"[[199901012359]]\"\n\"insert_links_with_titles\": false,\n```\n\nExamples how inserted links might look like depending on this setting:\n\n```markdown\n`insert_links_with_titles` is `true`:\n[[199901012359]] and note title\n\n\n`insert_links_with_titles` is `false`:\n[[199901012359]]\n```\n\n### IDs in titles of new notes\nWhen you create a new note, its title will automatically be inserted and an ID will be assigned to it (see [Creating a new note](#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`.\n\nExample for a note created with ID:\n\n```markdown\n# 201710310128 This is a note with its ID in the title\ntags=\n\nThe setting id_in_title is set to true.\n```\n\nExample for a note created without ID:\n\n```markdown\n# A note without an ID\ntags =\n\nThe setting id_in_title is set to false.\n```\n\nYou can find this setting in the file `sublime_zk.sublime-settings`.\n\n### New Note templates\n\nIf you need further customizing of how your new notes should look like, you can define your own template:\n\nIn your package's settings (user) just put in a line like this:\n```\n  \"new_note_template\": \"---\\nuid: {id}\\ntags: \\n---\\n\",\n```\n\nTo produce new notes like this:\n\n```\n---\nuid: 201711150402\ntags:\n---\n```\nThe format string works like this:\n\n* `\\n` creates a new line.\n* `{id}` : the note id like `201712241830`\n* `{title}` : note title like `Why we should celebrate Christmas`\n* `{origin_id}` : the id of the note you came from when creating a new note\n* `{origin_title}` : the title of the note you came from when creating a new note\n* `{file}` : the filename of the note like `201712241830 Why we should celebrate Christmas.md`\n* `{path}` : the path of the note like `/home/reschal/Dropbox/Zettelkasten`\n* `{timestamp: format-string}`: the date timestamp formatted by _format-string_, see [below]\n\n`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`.\n\n#### Date and time formatting options for timestamp\n\n| Directive | Meaning | Example |\n|-----------|---------|---------|\n|`%a`|Weekday as locale’s abbreviated name.|Sun, Mon, …, Sat (en_US); So, Mo, …, Sa (de_DE)|\n|`%A`|Weekday as locale’s full name.|Sunday, Monday, …, Saturday (en_US); Sonntag, Montag, …, Samstag (de_DE)|\n|`%d`|Day of the month as a zero-padded decimal number.|01, 02, …, 31 |\n|`%b`|Month as locale’s abbreviated name. | Jan, Feb, …, Dec (en_US); Jan, Feb, …, Dez (de_DE) |\n|`%B`|Month as locale’s full name. | January, February, …, December (en_US); Januar, Februar, …, Dezember (de_DE) |\n|`%m`|Month as a zero-padded decimal number.|01, 02, …, 12 |\n|`%y`|Year without century as a zero-padded decimal number.|00, 01, …, 99|\n|`%Y`|Year with century as a decimal number.|2017, 2018, …|\n|`%H`|Hour (24-hour clock) as a zero-padded decimal number.|00, 01, …, 23|\n|`%I`|Hour (12-hour clock) as a zero-padded decimal number.|00, 01, …, 12|\n|`%p`|Locale’s equivalent of either AM or PM.|AM, PM (en_US); am, pm (de_DE)|\n|`%M`|Minute as a zero-padded decimal number.|01, 02, …, 59 |\n|`%S`|Second as a zero-padded decimal number.|01, 02, …, 59 |\n|`%j`|Day of the year as a zero-padded decimal number.|001, 002, …, 366|\n|`%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|\n|`%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|\n|`%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)|\n|`%c`|Locale’s appropriate date representation.|08/16/88 (None); 08/16/1988 (en_US); 16.08.1988 (de_DE)|\n|`%%`|A literal `%` character.|%|\n\n##### Examples for note id **201802261632**:\n\n* `{timestamp: %Y-%m-%d %H:%M}`: _2018-02-26 16:32_\n* `{timestamp: %a, %b %d, %Y}`: _Mon, Feb 26, 2018_\n\n#### Example YAML note header\n\nTo produce a YAML note header (for pandoc), like this:\n\n```yaml\n---\nnote-id: 201802270019\ntitle:  Date Test\nauthor: First Last\ndate: 2018-02-27\ntags:\n---\n```\nyou can use the following settings:\n\n```json\n// when creating a new note, put id into title?\n // false to disable\n\"id_in_title\": false,\n\n// Template for new notes\n\"new_note_template\":\n    \"---\\nnote-id: {id}\\ntitle: {title}\\nauthor: First Last\\ndate: {timestamp: %Y-%m-%d}\\ntags: \\n---\\n\",\n```\n\n### Highlight references to other notes\nBy default, this plugin highlights links to other notes by underlining them.\n**Note:** This only applies to links containing an ID, like this one: [[201710290256]].\nIt also shows a bookmark symbol in the gutter to the left of your text. These features can be controlled via the following settings in `sublime_zk.sublime-settings`:\n\n```json\n    // highlight links to other notes?\n    \"highlight_note_links\": true,\n\n    // when highlighting: also show bookmark symbols in the gutter?\n    \"show_bookmarks_in_gutter\": true,\n```\n\n### Syntax Coloring for #tags, footnotes, and pandoc references\n\nTo enable highlighting of #tags, footnotes, and pandoc references in your newly created note, and for all your Zettelkasten notes, switch Sublime Text's syntax to `sublime_zk \u003e Markdown Zettelkasten`. You can use the menu: 'View' -\u003e 'Syntax' -\u003e 'Open all with current extension as...', and select 'sublime_zk \u003e Markdown Zettelkasten'.\n\n**DISCLAIMER:** As of 2018-05-07 evening, this package had to incorporate pretty much the entire [MarkdownExtended](https://github.com/jonschlinkert/sublime-markdown-extended) syntax from Jon Schlinkert. This was necessary because SublimeText build 3170 would not accept the previous syntax definition _(that just referenced any existing Markdown syntax)._\n\n#### Monokai Extended Color Scheme\n\n![default](https://user-images.githubusercontent.com/30892199/32641875-b241e6fa-c5d0-11e7-819a-4705396f633b.png)\n\nThis package provides the color scheme `Monokai Extended - Zettelkasten`. You can select it via the menu: Preferences -\u003e Color Scheme... -\u003e Monokai Extended - Zettelkasten. _(The original Monokai Extended for SublimeText has been created by [@jonschlinkert](https://github.com/jonschlinkert/sublime-monokai-extended))._\n\nThe _Monokai Extended - Zettelkasten_ color scheme is used for illustrations in this README.\n\nTo enable this color scheme for (just) your Zettelkasten notes automatically, stick the following into the `sublime_zk.sublime-settings`:\n\n```json\n    \"color_scheme\": \"Packages/sublime_zk/Monokai Extended-zk.tmTheme\",\n```\n\n#### Solarized Color Scheme\n\n![solarized](https://user-images.githubusercontent.com/30892199/38279419-7f1219e8-37a0-11e8-80e2-9ec9dd17f3a3.png)\n\nThis color scheme is installed under the name `Solarized (Light)-ZK`.\n\nIf you want the best Solarized aesthetics, [download](https://assets.ubuntu.com/v1/fad7939b-ubuntu-font-family-0.83.zip) the [Ubuntu Mono](https://design.ubuntu.com/font/) fonts and install the following 4 by double-clicking them:\n\n* `UbuntuMono-R.ttf`\n* `UbuntuMono-RI.ttf`\n* `UbuntuMono-B.ttf`\n* `UbuntuMono-BI.ttf`\n\nand then experiment with these settings in `sublime_zk.sublime-settings`:\n\n```json\n    // Solarized like The Archive\n    \"font_face\": \"Ubuntu Mono\",\n    \"color_scheme\": \"Packages/sublime_zk/Solarized (Light) - ZK.tmTheme\",\n    \"font_size\": 16,\n    \"line_padding_bottom\": 4,\n    \"line_padding_top\": 4,\n    \"line_numbers\": false,\n    \"gutter\": true,\n    \"margin\": 60,\n```\n\n\n#### Commodore 64 Color Scheme\n\nIf you know what a Commodore 64 is, you might enjoy this theme :smile:\n\n![c64](https://user-images.githubusercontent.com/30892199/38334682-49ee899c-385c-11e8-8a60-d3be99609f10.png)\n\nFor a perfect C64 experience, [download](http://style64.org/file/C64_TrueType_v1.2-STYLE.zip) the [best C64 True Type Font](http://style64.org/release/c64-truetype-v1.2-style), unzip it, and install the `C64 Pro Mono.ttf` by double clicking it.\n\nI used the following `sublime_zk.sublime-settings` for the screen-shot:\n\n```json\n    \"font_face\": \"C64 Pro Mono\",     // only if you have them installed\n    \"color_scheme\": \"Packages/sublime_zk/C64-ZK.tmTheme\",\n    \"font_size\": 12,\n    \"line_padding_bottom\": 4,\n    \"line_padding_top\": 4,\n    \"line_numbers\": false,\n    \"gutter\": true,\n    \"margin\": 80,\n    \"wrap_width\": 80,\n```\n\n\n#### Honorable Mention: Zettel Coffee Color Scheme\n\n![zettelcoffee](https://forum.zettelkasten.de/uploads/editor/xa/ogkjlnccbv5m.png)\n\nIf you're interested in a color scheme that attempts to resemble the nvALT scheme, then check out [Zettel Coffee](https://forum.zettelkasten.de/discussion/comment/1214/#Comment_1214).\n\n\n\n#### Rolling your own Color Scheme\n\nIf you want to use your own color scheme, you have to tweak it manually:\n\n* Google is your friend - make a copy of your existing color scheme\n* Add the following to your new color scheme\n* (Tweak the HTML color codes)\n\n```xml\n    \u003cdict\u003e\n      \u003ckey\u003ename\u003c/key\u003e\n      \u003cstring\u003eMarkup: Zettelkasten note link\u003c/string\u003e\n      \u003ckey\u003escope\u003c/key\u003e\n      \u003cstring\u003emarkup.zettel.link\u003c/string\u003e\n      \u003ckey\u003esettings\u003c/key\u003e\n      \u003cdict\u003e\n        \u003ckey\u003efontStyle\u003c/key\u003e\n        \u003cstring\u003eunderline\u003c/string\u003e\n        \u003ckey\u003eforeground\u003c/key\u003e\n        \u003cstring\u003e#7a9aff\u003c/string\u003e\n      \u003c/dict\u003e\n    \u003c/dict\u003e\n    \u003cdict\u003e\n      \u003ckey\u003ename\u003c/key\u003e\n      \u003cstring\u003eMarkup: Zettelkasten note link title\u003c/string\u003e\n      \u003ckey\u003escope\u003c/key\u003e\n      \u003cstring\u003emarkup.zettel.linktitle\u003c/string\u003e\n      \u003ckey\u003esettings\u003c/key\u003e\n      \u003cdict\u003e\n        \u003ckey\u003efontStyle\u003c/key\u003e\n        \u003cstring\u003eunderline\u003c/string\u003e\n        \u003ckey\u003eforeground\u003c/key\u003e\n        \u003cstring\u003e#7a9aff\u003c/string\u003e\n      \u003c/dict\u003e\n    \u003c/dict\u003e\n    \u003cdict\u003e\n      \u003ckey\u003ename\u003c/key\u003e\n      \u003cstring\u003eMarkup: Zettelkasten tag\u003c/string\u003e\n      \u003ckey\u003escope\u003c/key\u003e\n      \u003cstring\u003emarkup.zettel.tag\u003c/string\u003e\n      \u003ckey\u003esettings\u003c/key\u003e\n      \u003cdict\u003e\n        \u003ckey\u003efontStyle\u003c/key\u003e\n        \u003cstring\u003eitalic\u003c/string\u003e\n        \u003ckey\u003eforeground\u003c/key\u003e\n        \u003cstring\u003e#e42e70\u003c/string\u003e\n      \u003c/dict\u003e\n    \u003c/dict\u003e\n    \u003cdict\u003e\n      \u003ckey\u003ename\u003c/key\u003e\n      \u003cstring\u003eMarkup: Zettelkasten Image attrs in image link\u003c/string\u003e\n      \u003ckey\u003escope\u003c/key\u003e\n      \u003cstring\u003emeta.image.inline.markdown.imageattr\u003c/string\u003e\n      \u003ckey\u003esettings\u003c/key\u003e\n      \u003cdict\u003e\n        \u003ckey\u003eforeground\u003c/key\u003e\n        \u003cstring\u003e#F0E68C\u003c/string\u003e\n      \u003c/dict\u003e\n    \u003c/dict\u003e\n```\n\n### Configuring SublimeText's line spacing\nWhen looking at the screenshot at the beginning of this document, you might have noticed the line spacing. I find it very pleasant to work with text this way. To configure SublimeText to use this line spacing:\n\n* use the menu: \"Preferences\" --\u003e \"Settings - Syntax specific\"\n* SublimeText will show you two files side-by-side\n* change the one on the right side (also named `sublime_zk.sublime-settings`) as follows:\n\n```json\n// These settings override both User and Default settings for the sublime_zk syntax\n{\n\t\"line_padding_bottom\": 3,\n\t\"line_padding_top\": 3,\n}\n```\n**Note:** The above file is part of your \"User\" settings and will be created by SublimeText automatically. It is not the one you downloaded with this plugin. So please don't confuse the two :-)\n\n### Location of your .bib file\nIf you [work with bibliographies](#working-with-bibliographies), this plugin can make use of your `.bib` files to enable [auto-completion](#auto-completion-for-citekeys) for `@citekeys` (or `#citekeys` if you use MultiMarkdown) and [automatic creation of bibliographies](#automatic-bibliographies) inside of your notes.\n\n**Note:** If a `.bib` file resides in your note archive folder then the plugin will find it automatically. No configuration needed!\n\n**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.\n\nHowever, if you maintain your `.bib` file outside of your note archive then you can configure its location in the plugin's settings; just add a line like this:\n\n```\n    \"bibfile\": \"/path/to/zotero.bib\",\n```\n\nIn 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.\n\n### Citation Reference Style\n\nTwo major ways to handle citations in Markdown documents exist: Pandoc and MultiMarkdown. Which one you use, depends on your preferred tool-chain.\n\n**Note:** Pandoc style is the default, see below how to change this.\n\nExample for pandoc:\n\n```markdown\nReference to some awesome article [@awesome2017].\n\n\u003c!-- bibliography\n[@awesome2017]: Mr. Awesome. 2017. _On Being Awesome_\n--\u003e\n```\n\nExample for MultiMarkdown:\n\n```markdown\nReference to some awesome article [][#awesome2017].\n\n\u003c!-- bibliography --\u003e\n[#awesome2017]: Mr. Awesome. 2017. _On Being Awesome_\n\n```\n\nThe following line in the plugin's settings turns MultiMarkdown mode on:\n\n```\n\"citations-mmd-style\": true,\n```\n\n### Inline image preview size\nThis plugin can [show local images](#inline-local-image-display) directly inside your note. To make sure that huge images won't steal too much of your screen, you can limit their size by width. Larger images will always be scaled to not exceed the maximum width.\n\nThe default setting limits images to be 320 pixels wide:\n\n```\n    \"img_maxwidth\": 320,\n```\n\nNote: If you like, you can define a preview size on a per image basis. See [inline local image display](#inline-local-image-display) for more information.\n\n### Auto inline image preview\nIf you want images displayed automatically right when you open a note, put this into the plugin settings:\n\n```\n    \"auto_show_images\": true,\n```\n\n\n### Default Panes\n\nPlease see [Working with Panes](#working-with-panes) how to configure the default panes notes and results should open.\n\n## Usage\n\n### Shortcut cheatsheet\n\n* [Create a new note](#creating-a-new-note) \u003ckbd\u003eshift\u003c/kbd\u003e + \u003ckbd\u003eenter\u003c/kbd\u003e\n* [New note from text](#creating-a-new-note-and-link-from-selected-text) Select text, then \u003ckbd\u003eshift\u003c/kbd\u003e + \u003ckbd\u003eenter\u003c/kbd\u003e\n* [Open link with keyboard](#creating-a-link) Selector on text + \u003ckbd\u003ectrl\u003c/kbd\u003e + \u003ckbd\u003eenter\u003c/kbd\u003e\n* [Open link with mouse](#creating-a-link) \u003ckbd\u003eAlt\u003c/kbd\u003e + double-click on link\n* [Autocomplete find document](#creating-a-link) \u003ckbd\u003e[\u003c/kbd\u003e + \u003ckbd\u003e[\u003c/kbd\u003e\n* [Autocomplete to insert link](#using-auto-completion-to-insert-note-links) \u003ckbd\u003ectrl\u003c/kbd\u003e + \u003ckbd\u003espace\u003c/kbd\u003e\n* [Find references](#searching-for-friends) Selector in link + \u003ckbd\u003ealt\u003c/kbd\u003e + \u003ckbd\u003eenter\u003c/kbd\u003e\n* [View all tags](#getting-an-overview-of-all-your-tags) \u003ckbd\u003e#\u003c/kbd\u003e + \u003ckbd\u003e!\u003c/kbd\u003e\n* [View all notes](#listing-all-notes) \u003ckbd\u003e[\u003c/kbd\u003e + \u003ckbd\u003e!\u003c/kbd\u003e\n* [Autocomplete tag](#experimental-tag-selector) \u003ckbd\u003e#\u003c/kbd\u003e + \u003ckbd\u003e?\u003c/kbd\u003e\n* [Find tag references](#) Selector in tag \u003ckbd\u003ectrl\u003c/kbd\u003e + \u003ckbd\u003eenter\u003c/kbd\u003e\n* [Expand link inline](#inline-expansion-of-note-links) \u003ckbd\u003ectrl\u003c/kbd\u003e + \u003ckbd\u003e.\u003c/kbd\u003e\n* [Expand tag inline](#inline-expansion-of-tags) (with referencing notes) \u003ckbd\u003ectrl\u003c/kbd\u003e + \u003ckbd\u003e.\u003c/kbd\u003e\n* [Expand citekey inline](#inline-expansion-of-citekeys) (with referencing notes) \u003ckbd\u003ectrl\u003c/kbd\u003e + \u003ckbd\u003e.\u003c/kbd\u003e\n* [Insert multimarkdown citation](#inserting-a-citation) \u003ckbd\u003e[\u003c/kbd\u003e + \u003ckbd\u003e#\u003c/kbd\u003e (needs `\"citations-mmd-style\": true`)\n* [Insert pandoc citation](#inserting-a-citation) \u003ckbd\u003e[\u003c/kbd\u003e + \u003ckbd\u003e@\u003c/kbd\u003e (needs `\"citations-mmd-style\": false`)\n\n### Creating a new note\n\n* Press `[shift]+[enter]`. This will prompt you for the title of the new note at the bottom of your SublimeText window.\n* Press `[ESC]` to cancel without creating a new note.\n* Enter the note title and press `[enter]`.\n\n**Note:** `[shift]+[enter]` only works if you are in a note file or Zettelkasten project already. If it doesn't work, you can create a new note with the command palette:\n\n* bring up the command palette by pressing `[cmd]+[shift]+[p]` on macOS (`[ctrl]+[shift]+[p]` on Windows and Linux).\n* type `zk` to list the *Zettelkasten* commands.\n* select `ZK: New Zettel Note`\n\nA new note will be created and assigned the timestamp based ID in the format described above.\n\nExample: 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.\n\nThe new note will look like this:\n\n```markdown\n# AI is going to kill us all\ntags =\n.\n```\n\n### Creating a new note and link from selected text\n\nThere 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]`.\n\nThis 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.\n\nThe following animation illustrates this:\n\n![new-note-from-sel](https://user-images.githubusercontent.com/30892199/35781566-18734f7c-09ec-11e8-8bd6-c2ee3ed240c1.gif)\n\nAs a bonus feature, you can even select multiple lines and create a new note complete with title and body:\n\n* the first selected line will become the note's title\n* all the other selected lines will become the note's body (text).\n\n![new-note-from-multiline-sel](https://user-images.githubusercontent.com/30892199/36332808-fd458c9c-1373-11e8-9fe3-fa6755876499.gif)\n\n\n### Creating a link\nLet's assume, you work in the note \"201710282120 The rise of the machines\":\n\n```markdown\n# The rise of the machines\ntags = #AI #world-domination\n\nMachines are becoming more and more intelligent and powerful.\n\nThis might reach a point where they might develop a consciensce of their own.\n```\n\nYou 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.\n\nYou start typing:\n\n```markdown\n# The rise of the machines\ntags = #AI #world-domination\n\nMachines are becoming more and more intelligent and powerful.\n\nThis might reach a point where they might develop a consciensce of their own.\n\nAs a consequence, they might turn evil and try to kill us all ........... [[\n```\n\nThe 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:\n\n```markdown\n# The rise of the machines\ntags = #AI #world-domination\n\nMachines are becoming more and more intelligent and powerful.\n\nThis might reach a point where they might develop a consciensce of their own.\n\nAs a consequence, they might turn evil and try to kill us all ........... [[201710282118]]\n```\n\n**Note:** Only files ending with the extension specified in `sublime_zk.sublime-settings` (`.md` by default) will be listed in the popup list. If your files end with `.txt`, you need to change this setting.\n\n**Note:** With [this setting](#insert-links-with-or-without-titles) you can have the note's title inserted right after the link as well: `[[201710282118]] AI is going to kill us all`\n\nIf you now click into `[[201710282118]]` and press `[ctrl]+[enter]`, the target note will be opened where you can read up on how AI is potentially going to kill us all.\n\nHere you can see what the list of notes to choose from looks like:\n\n![screenshot2](https://user-images.githubusercontent.com/30892199/32403198-25f55650-c134-11e7-8f62-58fdbfb13c2b.png)\n\n#### Using auto-completion to insert note-links\nA different way to insert a link to another note is via auto-completion. This differs from the previous one in the following ways:\n\n* auto-completion is triggered via `[ctrl]+[space]` (or `[alt]+[/]` on Linux)\n* the list of notes is displayed at the location of your cursor\n* the font of the list is smaller, making it overall less obtrusive\n\nYou can, just as before, narrow the list auf auto-completion suggestions down by just continuing typing. However, once you write something that does not match anything in your note-list, the suggestions disappear. This is just how auto-completion works: it doesn't want to get in your way when you type something new.\n\nWhich ever method for link insertion you use is up to you.\n\nHere is a screenshot so you can compare:\n\n![screenshot2](https://user-images.githubusercontent.com/30892199/32403199-260fb374-c134-11e7-99ad-59e22852a095.png)\n\n**Note:** With [this setting](#insert-links-with-or-without-titles) you can have the note's title inserted right after the link as well, like in : `[[201710282118]] AI is going to kill us all`\n\n#### Implicitly creating a new note via a link\nThere is another way to create a new note: Just create a link containing its title and follow the link.\n\nTo 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.\n\nThis is what it might look like:\n\n```markdown\n# The rise of the machines\ntags = #AI #world-domination\n\nMachines are becoming more and more intelligent and powerful.\n\nThis might reach a point where they might develop a consciensce of their own.\n```\n\nYou 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:\n\n```markdown\n# The rise of the machines\ntags = #AI #world-domination\n\nMachines are becoming more and more intelligent and powerful.\n\nThis might reach a point where they might develop a consciensce of their own.\n\nAs a consequence, they might turn evil and try to kill us all ........... [[AI is going to kill us all]]\n```\n\n**Note:** You will have to press `[ESC]` after typing `[[` to get out of the note selection that pops up, before entering the note title.\n\n**Note:** Of course this also works if you use a single quote link: `[AI is going to kill us all]`.\n\nNow, 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 and press `[control]+[enter]`, just as you would if you wanted to open a regular linked note.\n\nAnd voila! A new note `201710282118 AI is going to kill us all.md` will be created and opened for you.\n\nBut 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:\n\n```markdown\n# The rise of the machines\ntags = #AI #world-domination\n\nMachines are becoming more and more intelligent and powerful.\n\nThis might reach a point where they might develop a consciensce of their own.\n\nAs a consequence, they might turn evil and try to kill us all ........... [[201710282118]]\n```\n\n**Note** how the note title \"AI is going to kill us all\" has been replaced by the note's ID \"201710282118\".\n\n**Note:** With [this setting](#insert-links-with-or-without-titles) you can have the note's title inserted right after the link as well, like in : `[[201710282118]] AI is going to kill us all`\n\nThe new note will be pre-filled with the following text:\n\n```markdown\n# AI is going to kill us all\ntags =\n.\n```\n\n#### Supported link styles\nWhen inserting links manually, you are can choose between the following supported link styles:\n\n```markdown\n## Wiki Style\n[[201711111707]] Ordinary double-bracket wiki-style links\n\n## Wiki Style with title\n[[201711111708 here goes the note's title]] same with title\n\n## Old-School\n§201711111709 support for old-school links :)\n\n## Single-Pair\n[201711111709] one pair of brackets is enough\n\n## Single-Pair with title\n[201711111709 one pair of brackets is enough]\n.\n```\n\nThis is how they are rendered in SublimeText:\n\n![link_styles](https://user-images.githubusercontent.com/30892199/33497107-fdaf0c50-d6cc-11e7-81d3-27af3ba9e740.png)\n\n\n### Searching for friends\nIf you see a link in a note and wonder what **other** notes also reference this note, then that is easy enough to do: Just click inside the link and press `[alt]+[enter]`.\n\n**Note:** If you have `ag` installed, the list of all referencing notes will pop up immediately in the permanent search result file:\n\n![silver-friends](https://user-images.githubusercontent.com/30892199/32641876-b25dae12-c5d0-11e7-8e03-f9b204902771.png)\n\nHowever, if `ag` is not installed, a _find-in-files_ panel will be opened, automatically pre-filled to search for the note-ID.\n\n![friend-search](https://user-images.githubusercontent.com/30892199/32442529-0aa52de8-c2fc-11e7-87fa-1f42b2a1c56b.png)\n\nJust press `[enter]` to start the search. The resulting notes will be displayed in a new tab \"Find Results\":\n\n![friend-results](https://user-images.githubusercontent.com/30892199/32442334-54ff1a76-c2fb-11e7-87ad-a551a9396f37.png)\n\n**Note:** The *Find Results* tab will be re-used in subsequent searches. In the screenshot above I have used a split layout; the results will always show up in the tab at the bottom.\n\n### Listing all notes\n\nThe shortcut \u003ckbd\u003e[\u003c/kbd\u003e + \u003ckbd\u003e!\u003c/kbd\u003e produces a list of all notes in the search results. This is probably most useful in [Zettelkasten Mode](#zettelkasten-mode).\n\n### Working with tags\n\n#### Getting an overview of all your tags\nOver 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.\n\nWhen you press `[#][!]` (that is the `#` key followed by the `!` key) quickly, a scratch file listing all your #tags will be created and showed right next to your text:\n\n![taglist](https://user-images.githubusercontent.com/30892199/32422037-fd32b18e-c29d-11e7-85d0-2d008b07fe1d.png)\n\n**Note:** If you don't like splitting your window, set the parameter `show_all_tags_in_new_pane` to `false`.\n\nOf course, if you have `ag` installed, the permanent search file will be used to display all your tags:\n\n![silver-tags](https://user-images.githubusercontent.com/30892199/32641877-b27b28fc-c5d0-11e7-89ac-20f1f83db586.png)\n\n#### Experimental tag selector\nPress `[#]+[?]` 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.\n\n![tagsel](https://user-images.githubusercontent.com/30892199/32405205-25f94bc0-c161-11e7-914a-1a82bdf9c2f9.png)\n\nWhy is this experimental? Because it needs to scan all your notes everytime you invoke it. This is probably not very efficient in large note archives, so I consider its implementation experimental. However, if you have `ag` [installed](#installing-the-silver-searcher), then you don't need to worry about that. _Ag_ will be detected and used automatically to speed things up a lot.\n\n\n#### Searching for notes containing specific tags\nLike note-links, tags can also be \"followed\" by clicking them and pressing `[ctrl]+[enter]`.\n\n**Note:** If you have `ag` installed, the list of all referencing notes will pop up immediately in the permanent search results file:\n\n![silver-follow-tag](https://user-images.githubusercontent.com/30892199/32641875-b241e6fa-c5d0-11e7-819a-4705396f633b.png)\n\nHowever, if `ag` is not installed, a _find-in-files_ panel will be opened, pre-filled with the clicked tag and your note archive folder.\n\n![tagsearch](https://user-images.githubusercontent.com/30892199/32421934-1e1411f0-c29d-11e7-8e08-7f7775e32542.png)\n\nPressing `[enter]` will start the search and show the search results in a new tab.\n\n![tagresults](https://user-images.githubusercontent.com/30892199/32421958-52a9cdec-c29d-11e7-9240-1a229a82351e.png)\n\n**Note:** The *Find Results* tab will be re-used in subsequent searches. In the screenshot above I have used a split layout; the results will always show up in the tab at the bottom.\n\n**Note:** If you set the parameter `show_search_results_in_new_tab` to `false`, then no new tab will be created for search results. They will be displayed in a little sort of pop-up at the bottom of the window.\n\n#### Advanced Tag Search\n\nTo search for more sophisticated tag combinations, use the command `ZK: Search for tag combination` from the command palette.\n\nIt will prompt you for the tags you want to search for and understands quite a powerful syntax; let's walk through it:\n\n##### Grammar and Syntax\n\n```\nsearch-spec: search-term [, search-term]*\nsearch-term: tag-spec [ tag-spec]*\ntag-spec: [!]#tag-name[*]\ntag-name: {any valid tag string}\n```\n\n**What does that mean?**\n\n* _search-spec_ consist of one or more _search-terms_ that are separated by comma\n* each _search-term_ consists of one or more _tag-specs_\n* each _tag-spec_\n    * can be:\n        * `#tag  ` : matches notes tagged with `#tag`\n        * `!#tag ` : matches all results that are **not** tagged with `#tag`\n    * and optionally be followed by an `*` asterisk to change the meaning of `#tag`\n        * from *exact* `#tag`\n        * to tags *starting with* `#tag`\n\n**How does this work?**\n\n* Each search is performed in the order the *search-terms* are specified.\n    * With each *search-term* the results can be narrowed down.\n    * This is equivalent to a logical _AND_ operation\n    * Example: `#car, #diesel` will first search for `#car` and then narrow all `#car` matches down to those also containing `#diesel`.\n        * This is equivalent to `#car` _AND_ `#diesel`.\n* Each *tag-spec* in a *search-term* adds to the results of that *search-term*.\n    * This is equivalent to a logical _OR_ operation.\n    * Example: `#car #plane` will match everything tagged with `#car` and also everything tagged with `#plane`\n        * This is equivalent to `#car` _OR_ `#plane`.\n* Each *tag-spec* can contain an `*` asterisk placeholder to make `#tag*` stand for *all tags starting with `#tag`*\n    * This works for `#tag*` and `!#tag*`.\n    * Examples:\n        * `#car*` : will match everything that contains tags starting with `#car`, such as: `#car`, `#car-manufacturer`, etc.\n        * `!#car*` : will match all results that do **not** contain tags starting with `#car`:\n            * `#plane #car-manufacturer` will be thrown away\n            * `#submarine` will be kept\n\n##### Putting it all together\n\nExamples:\n\n`#transport !#car` : all notes with transport **+** all notes not containing car (such as `#plane`)\n\nThere is no comma. Hence, two search terms will be evaluated and the results of all of them will be combined (_OR_).\n\n`#transport, !#car`: all notes with transport **-** all notes containing car\n\nHere, 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_).\n\nPretty powerful.\n\n`#transport #car, !#plane` : `#transport` or `#car` but never `#plane`\n\n`#transport #car !#plane` : `#transport` or `#car` or anything else that's not `#plane`\n\nI omitted examples using the `*` placeholder, it should be pretty obvious.\n\nThe following screen-shot illustrates the advanced tag search in action:\n\n* at the top right the results for `##AI, !#world*` are shown: only one note matches\n* at the bottom right the results for `##AI` are shown\n* the left side shows both notes containing `##AI`, one of them also tagged with `#world-domination` which gets eliminated by `, !#world*`.\n\n![adv_tag_search](https://user-images.githubusercontent.com/30892199/33188877-f53a9f88-d09d-11e7-9791-681ba9d7eeb3.png)\n\n### Expansion of overview notes with selective refresh\n\n#### Expansion of overview notes\n\nLet's say you have an overview note about a topic that links to specifics of that topic that looks like this:\n\n```markdown\nO - Text production\n\nThis is an **overview note** about text production with the Zettelkasten method.\n\nA few general words about our tool: Sublime ZK\n[[201711111707]] Sublime ZK is awesome\n[[201711111708]] Sublime ZK is great\n\nThen we go more in-depth:\n[[201711111709]] The specifics of how we produce text with the plugin\n\nCool!\n```\n\nThis overview is just a collection of note links with brief descriptions and a bit of additional text.\n\nNow, 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:\n\n* bring up the command palette by pressing `[cmd]+[shift]+[p]` on macOS (`[ctrl]+[shift]+[p]` on Windows and Linux).\n* type `zk` to list the *Zettelkasten* commands.\n* select `ZK: Expand Overview Note`\n\nEt voila! Depending on your linked notes, the overview note will be expanded into a new unsaved tab, maybe looking like this:\n\n![expanded](https://user-images.githubusercontent.com/30892199/32693323-613c43fe-c729-11e7-8773-04a9e20034f7.png)\n\nAs you can see, the lines containing note links are replaced by the contents of their notes, enclosed in comment lines. You can now edit and save this file to your liking.\n\n\n**Note**: If you want to refresh this expanded overview [(see below)](#refreshing-an-expanded-overview-note) later, then please leave those comments in!\n\n**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](#refreshing-an-expanded-overview-note) this overview.\n\n\n#### Refreshing an expanded overview note\n\nIt 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:\n\n* bring up the command palette by pressing `[cmd]+[shift]+[p]` on macOS (`[ctrl]+[shift]+[p]` on Windows and Linux).\n* type `zk` to list the *Zettelkasten* commands.\n* select `ZK: Refresh Expanded Note`\n\n**Note:** Only notes with comments starting with `\u003c!-- !` will be considered for a refresh.\n\n**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 `\u003c!-- `. Alternatively, you can, of course, delete the comment lines for parts you are sure will never need refreshing.\n\nThe following animation illustrates expansion and refreshing:\n\n![overview-expansion](https://user-images.githubusercontent.com/30892199/32693096-f2c69ffe-c724-11e7-9c6a-d01857e86ce1.gif)\n\n### Inline expansion of note-links\n\nOverview 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.\n\nManually expanding a note link is easy: You must have your cursor over (\"in\") a note link, obiously. The key combination `[ctrl]+[.]` or `ZK: Expand Link inline` from the command palette 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.\n\nHere is an example using the already well-known AI notes: Let's start with our first note:\n\n```markdown\n# The rise of the machines\ntags = #AI #world-domination\n\nMachines are becoming more and more intelligent and powerful.\n\nThis might reach a point where they might develop a consciensce of their own.\n\nAs a consequence, they might turn evil and try to kill us all ........... [[201710282118]]\n```\n\nNow if you put your cursor inside the `[[201710282118]]` link and press `[ctrl]+[.]`, the text will change into this:\n\n```markdown\n# The rise of the machines\ntags = #AI #world-domination\n\nMachines are becoming more and more intelligent and powerful.\n\nThis might reach a point where they might develop a consciensce of their own.\n\nAs a consequence, they might turn evil and try to kill us all ........... [[201710282118]]\n\n\u003c!-- !    [[201710282118]] AI is going to kill us all    --\u003e\n# AI is going to kill us all\ntags =\n\n\u003c!-- (End of note 201710282118) --\u003e\n```\n\n*(We've never actually written anything into the linked note. Usually there would be lots of text)*\n\n**Note:** To remember `[ctrl]+[.]`: I wanted to use `...` as shortcut for expansion but it didn't work out :smile:\n\n**Hint:** If, after expansion, you don't like what you see, just undo! :smile:\n\n**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.\n\n### Inline expansion of #tags\nAnother 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.\n\nThe following animation shows inline expansion of #tags in action:\n\n![expand-tag](https://user-images.githubusercontent.com/30892199/36258162-f198e972-1259-11e8-8b9c-0d6f4519c1e1.gif)\n\n### Inline expansion of citekeys\nIn 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*.\n\n**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`.\n\nThe following animation shows inline expansion of citekeys in action:\n\n![expand-citekey](https://user-images.githubusercontent.com/30892199/36260348-6e56236a-1261-11e8-8046-fb7a9e246b9a.gif)\n\n\n\n### Working with Bibliographies\n\n#### Inserting a citation\nIf your note archive contains one or you [configured](#location-of-your-bib-file) 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.\n\nA 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]`.\n\nWhen you made your choice, a citation link will be inserted into the text: `[@citekey]` (or `[][#citekey]` if you [use MultiMarkdown style](#citation-reference-style)).\n\nThe following animation shows this in action:\n\n![insert-citation](https://user-images.githubusercontent.com/30892199/35771311-e8da9b06-092a-11e8-847b-aa1649da499d.gif)\n\n\n#### Auto-Completion for @citekeys\nIf your note archive contains one or you [configured](#location-of-your-bib-file) a `.bib` file, then the auto-completion suggestions you get via `[ctrl]+[space]` (or `[alt]+[/]` on Linux) will also contain your cite-keys, marked by a starting `@` symbol. (If you [use MultiMarkdown style](#citation-reference-style), they will start with a `#` sign instead). Pressing `[enter]` will insert a pandoc citation like this: `[@citekey]` (or `[][#citekey]` if you use MultiMarkdown style).\n\n**Note:** Never actually press the `@` key when searching for cite-keys. At least on my system SublimeText will always insert the current suggestion when pressing `@` :(.\n\n#### Automatic Bibliographies\nIt 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](#location-of-your-bib-file) one, then this plugin can take care of all your citations for you.\n\n**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](https://pandoc.org/installing.html), it's a breeze.\n\nIn any note with citations:\n\n* just bring up the command palette with `[ctrl]+[shift]+[p]` (or `[cmd]+[shift]+[p]` on macOS)\n* type `zk` to see all the Zettelkasten commands\n* and select `ZK: Auto-Bib`\n\nThis will add a long comment to your note in the following format *(line wrapping added for github manually)*:\n\n```markdown\n\u003c!-- references (auto)\n\n[@AhrensHowTakeSmart2017]: Ahrens, Sönke. 2017. _How to Take Smart Notes: One Simple Technique\nto Boost Writing, Learning and Thinking for Students, Academics and Nonfiction Book Writers_. 1st ed.\nCreateSpace Independent Publishing Platform.\n\n[@FastZettelkastenmethodeKontrollieredein2015]: Fast, Sascha, and Christian Tietze. 2015.\n_Die Zettelkastenmethode: Kontrolliere dein Wissen_. CreateSpace Independent Publishing Platform.\n\n--\u003e\n```\n\nThe animation below shows how handy this is :smile:\n\n![autobib](https://user-images.githubusercontent.com/30892199/33105451-6851a402-cf2d-11e7-8b5a-3d869a269aa0.gif)\n\n**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](#citation-reference-style) `citations-mmd-style` to `true`, then the `[#citekey]: ...` MultiMarkdown notation will be used.\n\n**WARNING**: Do not write below the generated bibliography. Everything after `\u003c!-- references (auto)` will be replaced when you re-run the command!\n\n#### Searching for notes referencing a specific citekey\n\nIn 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 pressing `[ctrl]+[enter]`.\n\n\n\n**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`.\n\nAs usual, if you have `ag` installed, as is recommended, this will make the most sense, because search results will show up in the external search results, as is illustrated by the following animation:\n\n![follow-citekey](https://user-images.githubusercontent.com/30892199/36261085-86e70708-1263-11e8-8b0f-fa2c95498b88.gif)\n\n\n### Inline Local Image Display\nMarkdown notes are great! Especially because they are text-based. Sometimes, though, they contain images. Well, **links** to images: you only see them when you convert your note into a format that supports images.\n\nThanks to this plugin, you can now even view your **local** images directly in SublimeText:\n\n* just bring up the command palette with `[ctrl]+[shift]+[p]` (or `[cmd]+[shift]+[p]` on macOS)\n* type `show`\n* select `ZK: Show Images`\n\n**Note**: This *only* works with images stored in your note archive folder (or a subfolder thereof).\n\nYou can configure a [size limit](#inline-image-preview-size) for images to make sure big ones don't cover all your screen.\n\nTo hide them:\n\n* bring up the command palette with `[ctrl]+[shift]+[p]` (or `[cmd]+[shift]+[p]` on macOS)\n* type `show`\n* select `ZK: Hide Images`\n\n![inline_imgs](https://user-images.githubusercontent.com/30892199/33154565-7df466ac-cfe9-11e7-8920-b204fa4dcb02.gif)\n\n**Note:** If you want images automatically displayed right when you open a note, you can [configure](#auto-inline-image-preview) that.\n\n#### Per image preview size\nYou can define a specific preview size per image by adding image attributes inside a pair of curly braces as shown below:\n\n```markdown\n![xxx](img/zettelkasten-book-de.jpg){width=100% height=100%}\n![xxx](img/zettelkasten-book-de.jpg){width=200px height=200px}\n.\n```\n\n**Note:**\n\n* SublimeText requires you to specify both width and height when you specify your own attributes.\n* SublimeText seems to have its own interpretation of how big a pixel is\n* If you don't want to manually convert width and height to scaled values, then just use percentages. Start with 100% for each and take it from there.\n\n### Section Numbering and Table Of Contents\n\nThis plugin lets you pep up your texts with automatically numbered sections and tables of content.\n\n#### Automatic Table Of Contents\nSome 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 the [markdown preview](https://github.com/revolunet/sublimetext-markdown-preview) plugin to quickly check your text in a browser.\n\nTo insert a table of contents at your current cursor position:\n\n* bring up the command palette with `[ctrl]+[shift]+[p]` (or `[cmd]+[shift]+[p]` on macOS)\n* type `zktoc`\n* select `ZK: Auto-TOC`\n\nThe table of contents will be placed between two automatically generated comments that also serve as markers for the plugin. 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 another format, e.g. by using the *markdown preview* plugin.\n\nWhy 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.\n\nExample before TOC:\n\n```markdown\n# 201711250024 Working with tocs\ntags = #sublime_zk #toc\n\n\n## This is a very long note!\nAt least we pretend so.\n\n## It contains many headings\nThat's why we are going to need a table of contents.\n\n### **with funny chäråcters!**\nFunny characters can be a challenge in the `(#references)`.\n\n## as can duplicate headings\n\n# as can duplicate headings\n.\n```\n\nExample after TOC:\n\n```markdown\n# 201711250024 Working with tocs\ntags = #sublime_zk #toc\n\n\u003c!-- table of contents (auto) --\u003e\n* [201711250024 Working with tocs](#201711250024-working-with-tocs)\n    * [This is a very long note!](#this-is-a-very-long-note)\n    * [It contains many headings](#it-contains-many-headings)\n        * [**with funny chäråcters!**](#with-funny-characters)\n    * [as can duplicate headings](#as-can-duplicate-headings)\n* [as can duplicate headings](#as-can-duplicate-headings_1)\n\u003c!-- (end of auto-toc) --\u003e\n\n## This is a very long note!\nAt least we pretend so.\n\n## It contains many headings\nThat's why we are going to need a table of contents.\n\n### **with funny chäråcters!**\nFunny characters can be a challenge in the `(#references)`.\n\n## as can duplicate headings\n\n# as can duplicate headings\n.\n```\n\n**Note:** Whenever you need to refresh the table of contents, just repeat the above command.\n\n**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](https://pandoc.org/), you should set it to `-`.\n\nThe following animation shows TOC insertion and refreshing in action:\n\n![auto-toc](https://user-images.githubusercontent.com/30892199/33225714-6b7aeb32-d17d-11e7-9d72-d2d890b0394c.gif)\n\n\n#### Automatic Section Numbering\n\nEspecially 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 by the plugin as follows:\n\n* bring up the command palette with `[ctrl]+[shift]+[p]` (or `[cmd]+[shift]+[p]` on macOS)\n* type `zk`\n* select `ZK: Number Headings`\n\nAutomatically inserted section numbers will look like in the following note:\n\n```markdown\n# 1  201711250024 Working with tocs\ntags = #sublime_zk #toc\n\n\n## 1.1  This is a very long note!\nAt least we pretend so.\n\n## 1.2  It contains many headings\nThat's why we are going to need a table of contents.\n\n### 1.2.1  **with funny chäråcters!**\nFunny characters can be a challenge in the `(#references)`.\n\n## 1.3  as can duplicate headers\n\n# 2  as can duplicate headers\n.\n```\n\n**Note:** You can refresh the section numbers at any time by repeating the above command.\n\n**Note:** To switch off numbered sections, use the command `ZK: Remove Heading Numbers`.\n\nThe animation below shows both section (re-)numbering and auto-TOC:\n\n![section-numbers](https://user-images.githubusercontent.com/30892199/33226705-12169142-d194-11e7-940a-8a8e26c054ae.gif)\n\n### Working with Panes\n\nThis only applies if you have split your window into multiple panes and you are not using the [Zettelkasten Mode](#zettelkasten-mode). By default, notes are opened in the first pane and if you have `ag` installed, search results are opened in the second pane. So in a 2-column layout notes are left and results are right. In a 2-row layout notes are at the top, results at the bottom. Notes are opened when clicking on a note-link or creating a new note, results are displayed by the various search operations, tag list, etc.\n\nIf you have a more complex layout or you want to change the default target panes, there is a command for you:\n\n* bring up the command palette by pressing `[cmd]+[shift]+[p]` on macOS (`[ctrl]+[shift]+[p]` on Windows and Linux).\n* type `zk` to list the *Zettelkasten* commands.\n* select `ZK: Select Panes for opening notes/results`\n\nThis will first prompt you for the pane number notes should be opened in and, if you have `ag` installed, it will then prompt you for the pane number results should be opened in.\n\nTo help you with finding out the pane numbers, it shows a pane identifier inside each pane, reading \"Pane _n_\", where _n_ is the pane's number.\n\nThe following screenshot illustrates that:\n\n![panes](https://user-images.githubusercontent.com/30892199/33515865-e400ca54-d768-11e7-8fba-c641871c0cc0.png)\n\nThe plugin will remember your choices as long as SublimeText is running. To make these changes permanent, add the following to the plugin's settings:\n\n```json\n    // Pane where notes are opened when a link is clicked or a new note is created\n    // Pane 0 is the 1st pane ever\n    \"pane_for_opening_notes\": 0,\n    //Pane where search results and tag lists, etc are opened (if ag is installed)\n    // Pane 1 is the second pane, created when you split the window\n    //    in a 2-column layout, this is the right column\n    //    in a 2-row layout, this is the bottom row\n    \"pane_for_opening_results\": 1,\n```\n\n## Zettelkasten Mode\n\nFor a sublime Zettelkasten experience, you can enter the Zettelkasten mode:\n\n* bring up the command palette by pressing `[cmd]+[shift]+[p]` on macOS (`[ctrl]+[shift]+[p]` on Windows and Linux).\n* type `zk` to list the *Zettelkasten* commands.\n* select 'ZK: Enter Zettelkasten Mode'\n\nThis will:\n\n* split your SublimeText window into 3 parts:\n    * the left parts where your tabbed notes are displayed\n    * the top right part where search results are displayed\n    * the bottom right part where your [saved searches](#saved-searches) are displayed\n\nThe Zettelkasten Mode allows for easy mouse navigation through your note archive.\n\n**Remember: ALT + DOUBLECLICK** is sometimes more convenient than \u003ckbd\u003eCTRL\u003c/kbd\u003e + \u003ckbd\u003eENTER\u003c/kbd\u003e\n\nIf your search results are empty, a little welcome text with some useful keyboard shortcuts will be displayed. If you don't have any [saved searches](#saved-searches) yet, a few sample searches will be created. This is shown in the screen-shot below:\n\n![zkmode_2](https://user-images.githubusercontent.com/30892199/38537649-13d898d8-3c90-11e8-887c-126876f7a2ec.png)\n\n**Note:** If you have upgraded this package and entered the Zettelkasten Mode for the first time, SublimeText may be confused about the syntax of your notes. In that case, open a note and use the menu: 'View' -\u003e 'Syntax' -\u003e 'Open all with current extension as...', and select 'sublime_zk \u003e Markdown Zettelkasten'.\n\n### Saved Searches\n\nThe Zettelkasten mode introduces a saved searches file. This is a simple Text file where you can name and store search terms.\n\nIts syntax is very simple; to define a search, you just add a line, consisting of the following parts:\n\n* an optional search name\n* a colon `:`\n* a search-spec (see [advanced tag search](#advanced-tag-search) for more information)\n    * `#!` (all tags) and `[!` (all notes) are also valid search-specs\n\nThe `search-spec` will be highlighted in the file, so you know exactly what will be searched for.\n\nYou can place Markdown headings anywhere in the file, too, like this:\n\n```markdown\n# Tag Searches\njust one  tag:          #tag\ntag1 or  tag2:          #tag1  #tag2\ntag1 and tag2:          #tag1, #tag2\n\n# A bit more complex\ntag1 but not tag2:                 #tag1, !#tag2\ntag1 or anything that's not tag2 : #tag1 !#tag2\n\n# Wildcard searches\nanything starting with auto : #auto*\nanything starting with auto but nothing starting with plane: #auto*, !#plane*\n```\n\nYou can execute the search in one of two ways:\n\n* Place the cursor on a search line (no need to hit the search spec) and press \u003ckbd\u003ectrl\u003c/kbd\u003e + \u003ckbd\u003eenter\u003c/kbd\u003e\n* Press \u003ckbd\u003eALT\u003c/kbd\u003e and double-click in a search line\n\nIn the animation below, the mouse was used.\n\n![zk_mode_demo](https://user-images.githubusercontent.com/30892199/38536016-0905acf6-3c87-11e8-986a-43b09b014847.gif)\n\n## Credits\n\nCredits, where credits are due:\n\n* I derived parts of this work from Dan Sheffler's MyWiki code. [See his GitHub](https://github.com/dansheffler/MyWiki) and see some striking similarities ;-).\n* (Of course it has evolved a lot since. A special shoutout to @toolboxen from the forum at zettelkasten.de for all the ideas, github issues, and pull requests!)\n* Thanks to [Niklas Luhmann](https://en.wikipedia.org/wiki/Niklas_Luhmann) for coming up with this unique way of using a Zettelkasten.\n* Thanks to the guys from [zettelkasten.de](https://zettelkasten.de) for their Zettelkasten related resources. There are not that many out there.\n\nWhile we're at it, I highly recommend the following books (German); Google and Amazon are your friends:\n\n* \"Das Zettelkastenprinzip\" / \"How to take smart notes\" [(more info here...)](http://takesmartnotes.com/#moreinfo) will blow your mind.\n* \"Die Zettelkastenmethode\" from Sascha over at zettelkasten.de will also blow your mind and expand on the plain-text approach of using a digital Zettelkasten.\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frenerocksai%2Fsublime_zk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frenerocksai%2Fsublime_zk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frenerocksai%2Fsublime_zk/lists"}