Awesome `linky-note` is a Python cli/package created with https://github.com/TezRomacH/python-package-template
Project description
linky-note
🤔 Description
This project provide a markdown to markdown converter that adds a Bi-Directional Link Section at the end of each markdown files that is converted. It is heavily inspired by the note-link-janitor
The project also provide a pre-commit hook so you can easily integrate it within your own projects easily
It relies heavily on the Marko python package that is the only Markdown Parser with a Markdown Renderer that I know of.
💭 Why
I believe a great amount of information can be extracted from collaborative notes if we take time to structure them correctly.
I wanted:
- To make collaborative notes
- To organize the notes in a Roam like manner
- Everyone to be able to navigate through the notes without installing anything
- This system to be easily adopted by a software engineering team.
Using git and this converter as a pre-commit, I can easily do all of this ! 🚀
✨ Features
- Understands both Wikilinks and Markdown links
- Can use a reference system based on Title as unique Keys or filename as unique key
- Can convert wikilinks to markdown links and reciprocally
- All this, entirely configurable through a simple stepper using
linky-note init
command
🏃 Getting Started
Installation as a python package with pip
Considering you already have python available. You can simply add th
pip install --user linky_note
Then you can see all the option of the CLI using
linky_note --help
It is advised to start by configuring the CLI using
linky_note init
You can then apply the conversion
linky_note apply <INPUT_DIR> --output-dir <OUTPUT_DIR>
If no OUTPUT_DIR
is given, it will overwrite the files in INPUT_DIR
Installation as a pre-commit hook
This pre-commit hook use the [pre-commit](https://pre-commit.com) tool that you will need to install.Add the following line to your pre-commit configuration (.pre-commit-config.yaml
) at the root of your
repository.
repos:
- repo: https://github.com/jb-delafosse/linky_note
rev: v0.4.0
hooks:
- id: linky_note apply
args: ['directory-containing-my-markdown']
and install the hook using pre-commit install
You should also run linky init
at the root of your repo to configure linky-note
🛡 License
This project is licensed under the terms of the MIT
license. See LICENSE for more details.
📃 Citation
@misc{linkynote,
author = {jb-delafosse},
title = {Awesome `linkynote` is a Python cli/package created with https://github.com/TezRomacH/python-package-template},
year = {2020},
publisher = {GitHub},
journal = {GitHub repository},
howpublished = {\url{https://github.com/jb-delafosse/linkynote}}
}
Credits
This project was generated with python-package-template
.
It is heavily inspired by the note-link-janitor
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for linky_note-0.4.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 00051a71fd8dc6ec02850fe186fba5ee77f0cb9763a5ae275c1b01c9d746c2a8 |
|
MD5 | fa0cb3f2206f481d93660a233d11b8e6 |
|
BLAKE2b-256 | c2822d49710341006c78e9c3073017c6ad2f454a1f18863abeafdede1810b2ae |