Provide scientists, IT professionals but also normal people, with a solid, lightweight note-taking GUI, with tag browsing and a clear interface.
Based on a customized markdown syntax, it supports mathematics. The modification of the syntax, parsed internally, allows to store tags for posts, for easier filtering when previewing a large document.
It is aimed to store small notes, remarks on program, life-pro-tips found while developing/researching, in a safe place, reachable without internet access.
Eventually, it should also support longer posts (blog-like), and more specialised types of notes, like ones for experimental work.
Note Organiser uses the standard Python distutils tool for installing. Simply issue:
python setup.py install --user
when in the main directory. It requires PySide, and pypandoc, which will be installed if not present. Be warned, PySide is a huge install. Go walk outside for a bit.
To get you started, look at the file example/example.md
.
Simply run, from anywhere, NoteOrganiser.py
. Create notebooks, add entries
with the New Entry
button in the Editing panel, and preview them. On the
Preview
panel, you can filter entries with tags.
For those still not familiar with Markdown, you can check the original code, developed by John Gruber here. It is a markup language designed to be clear and readable, and easily converted to html for a better visualisation.
Note Organiser converts notes taken in markdown with an additional syntax for tags and date. The conversion is made through the python wrapper pypandoc of the pandoc document converter. The format will be recognised automatically, and supports most extensions of markdown. A useful cheat-sheet to consult is available on this Github wiki.
see the roadmap (display in raw format, since Github does not apply the Github flavored syntax to files) for coming features, and make use of the issues page to propose improvements.
The code is published under the MIT license, please see LICENSE.txt for the complete notice.
Contributions are welcome, so please submit a bug-report or a feature request. Pull-Request are also very appreciated. Please think about running the tests under both python 2.7 and 3.3 before submitting, though!