{"id":14065872,"url":"https://github.com/klieret/verzettler","last_synced_at":"2025-04-28T15:49:51.527Z","repository":{"id":40451150,"uuid":"246102038","full_name":"klieret/verzettler","owner":"klieret","description":"Non-linear, non-hierarchical knowledge management: Helper scripts for your Zettelkasten.","archived":false,"fork":false,"pushed_at":"2025-01-07T01:45:10.000Z","size":527,"stargazers_count":19,"open_issues_count":5,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-30T10:51:15.906Z","etag":null,"topics":["markdown","markdown-viewer","markdownserver","note-taking","notes","webserver","zettelkasten","zettlr"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/klieret.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-09T17:39:59.000Z","updated_at":"2024-12-29T13:41:13.000Z","dependencies_parsed_at":"2024-10-23T08:37:18.883Z","dependency_job_id":"f557be45-801a-4c05-8235-b7b96775354b","html_url":"https://github.com/klieret/verzettler","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klieret%2Fverzettler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klieret%2Fverzettler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klieret%2Fverzettler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klieret%2Fverzettler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/klieret","download_url":"https://codeload.github.com/klieret/verzettler/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251342689,"owners_count":21574242,"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","markdown-viewer","markdownserver","note-taking","notes","webserver","zettelkasten","zettlr"],"created_at":"2024-08-13T07:04:47.503Z","updated_at":"2025-04-28T15:49:51.508Z","avatar_url":"https://github.com/klieret.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Verzettler\n\n\u003c!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section --\u003e\n[![All Contributors](https://img.shields.io/badge/all_contributors-2-orange.svg?style=flat-square)](#contributors-)\n\u003c!-- ALL-CONTRIBUTORS-BADGE:END --\u003e\n![experimental](https://img.shields.io/badge/-experimental-red)\n![gh actions](https://github.com/klieret/verzettler/workflows/testing/badge.svg)\n[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/klieret/verzettler/master.svg)](https://results.pre-commit.ci/latest/github/klieret/verzettler/master)\n[![Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/python/black)\n[![License](https://img.shields.io/github/license/klieret/verzettler.svg)](https://github.com/klieret/verzettler/blob/master/LICENSE.txt)\n[![PR welcome](https://img.shields.io/badge/PR-Welcome-%23FF8300.svg)](https://git-scm.com/book/en/v2/GitHub-Contributing-to-a-Project)\n\n**This project is more of an easy to hack experimental playground than a finished product**\n\nI'm using parts of it on a regular basis, and you probably will find some helpful\ntooling there as well. But it's not a coherent polished package.\nIf you have come cool additions or suggestions, I'm all ears though.\n\n## Non-linear, non-hierarchical knowledge management\n\nKnowledge management is about storing information in a way that makes sense to you. The canonical approach is linear and hierarchical in nature: You start with a simple text document. The more information you add, the longer it grows, eventually becoming hard to manage. If your knowledge falls into some disjoint categories, you might have several different documents in different folders, but eventually it will be very hard to figure out the right place for pieces of information as the structure becomes ever more complex.\n\nThe Zettelkasten (German for *slipbox*) method is a radical departure from this: Notes are limit to a single thought or information with very high cohesion and rather than imposing a linear or hierarchical structure, these notes are linked together. Pretty much what makes the WWW scale so well ;)\n\nBut let me refer you to other people for the big words. I really enjoyed [this article](https://writingcooperative.com/zettelkasten-how-one-german-scholar-was-so-freakishly-productive-997e4e0ca125) about [Niklas Luhman](https://en.wikipedia.org/wiki/Niklas_Luhmann), a German Sociologist of the 20th century who built up an analogue knowledge management system made from thousands of small notes.\n\n### Notable existing software solutions\n\n| Name                                                         | Open source? | Description        |\n| ------------------------------------------------------------ | ------------ | ------------------ |\n| [roamresearch](https://roamresearch.com/)                    | No           |                    |\n| [org-roam](https://github.com/org-roam/org-roam)             | Yes          | Plugin for emacs   |\n| [org-brain](https://github.com/Kungsgeten/org-brain)         | Yes          | Plugin for emacs   |\n| [logseq](https://github.com/logseq/logseq)                   | Soon (?)     | In-browser         |\n| [zettlr](https://github.com/Zettlr/Zettlr)                   | Yes          | Electron based app |\n| [obsidian](https://obsidian.md/)                             | No           | Electron based app |\n\nAnd certainly many more (feel free to open a PR to add your favorite piece of software)!\n\n## The tools in this repository\n\nThis repository contains a selection of different tools to help you manage your own Zettelkasten, which are kept as Markdown files in a way that [Zettlr](https://www.zettlr.com/) and others understand them.\n\nAmong these are\n\n* Tools to make bulk operations on your notes. E.g. to introduce backlinks (a section at the end of each note where all notes that link to the note are linked)\n* Tools to convert your notes to other formats.\n* A local web server to browse through your notes through your web server. Experimental support to edit your notes directly in your webbrowser was recently implemented as well.\n* Tools to analyze the graph structure of your Zettelkasten.\n\nEventually this project might converge to a browser based tool to fully manage your notes directly from the webbrowser while keeping support for other external editors, but currently it's still bits and pieces.\n\n## Selected features\n\n### The webserver\n\n* The webserver shows a smart portion of the graph of neighboring nodes for each note:\n\n![note environment graph](readme_assets/note_environment_graph_small.png)\n\n* It also has a fancy dashboard that shows some statistics about the distribution of notes:\n\n![dashboard](readme_assets/dashboard_small.png)\n\n* Shortcut buttons to open the note in an external editor (like `typora`)\n* Edit note in browser (alpha)\n\n## Installation\n\nVerzettler needs python \u003e= 3.7. You can install this project using\n\n```sh\npip3 install .\n```\n\nPlease also make sure that you have the `pandoc` package installed\n(not with ``pip`` but with your usual package manager/installer).\n\n### Development installation\n\nPlease install the pre-commit hooks and tools for testing\n\n```\npip3 install pre-commit pytest pytest-cov\ncd verzettler\npre-commit install\n```\n\n## Contributors ✨\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/Pablo2m\"\u003e\u003cimg src=\"https://avatars3.githubusercontent.com/u/557413?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003ePablo2m\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/klieret/verzettler/commits?author=Pablo2m\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"https://github.com/klieret/verzettler/issues?q=author%3APablo2m\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e \u003ca href=\"#ideas-Pablo2m\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://www.lieret.net\"\u003e\u003cimg src=\"https://avatars3.githubusercontent.com/u/13602468?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eKilian Lieret\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/klieret/verzettler/commits?author=klieret\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"#ideas-klieret\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e \u003ca href=\"#maintenance-klieret\" title=\"Maintenance\"\u003e🚧\u003c/a\u003e \u003ca href=\"https://github.com/klieret/verzettler/pulls?q=is%3Apr+reviewed-by%3Aklieret\" title=\"Reviewed Pull Requests\"\u003e👀\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003c!-- markdownlint-enable --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\nThis project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fklieret%2Fverzettler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fklieret%2Fverzettler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fklieret%2Fverzettler/lists"}