Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jmcerrejon/frodown
Simple markdown editor with frontmatter support.
https://github.com/jmcerrejon/frodown
editor frontmatter gui markdown python python3 tui vitepress vuepress
Last synced: 11 days ago
JSON representation
Simple markdown editor with frontmatter support.
- Host: GitHub
- URL: https://github.com/jmcerrejon/frodown
- Owner: jmcerrejon
- License: other
- Created: 2024-02-15T10:20:40.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2024-04-05T07:00:56.000Z (10 months ago)
- Last Synced: 2024-12-03T14:16:22.529Z (2 months ago)
- Topics: editor, frontmatter, gui, markdown, python, python3, tui, vitepress, vuepress
- Language: Python
- Homepage:
- Size: 289 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Frodown
## Frontmatter + Markdown editor
This is a simple markdown editor with _Frontmatter_ support. It's built using _Python_ + a great _TUI (Terminal User Interface)_ called _Textual_. More info at [textualize.io](https://textualize.io).
It's the tool I use to write my blog posts and other markdown files. I built my blog using [VuePress 2](https://v2.vuepress.vuejs.org) + [Hope](https://theme-hope.vuejs.press) theme. You can visit me at https://misapuntesde.com
## Features
- [x] Frontmatter/Markdown support.
- [x] Dark/Light theme (because I think some people prefer brightness 🤷♂️).
- [x] Markdown zen mode & improvements on typewriting.
- [x] Auto-draft mode: Open with the latest options if you quit without saving the information previously.
- [x] Local AI to suggest tags using Ollama. 🤯
## TODO
- [x] Add a footer.
- [x] Save to a file.
- [x] Markdown cheat sheet on the sidebar.
- [x] Move categories and other constants to an environment or text file.
- [ ] If you have multi-language support on your site, create multiple markdown files.
- [ ] Accept parameters from the command line.
- [ ] Package it as a standalone app.
## Power UP! 🚀
Could an **application work as a server, from Terminal (TUI) AND with a _GUI_ on _macOS, Windows & Linux_, all at the same time?** It sounds crazy!! Let's do it!
- [ ] GUI App. 🚀
- [ ] Website App running as a web server.
## How to use
I chose the _TOML_ format for the settings, so please rename the file `settings.toml.example` and update the settings in your file.
Change the constants in the `main.py` and `categories.txt` files to match your needs. Then, run the following commands:
```bash
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python main.py
```
Clicking on **[Save]** will save it to the same directory with the title 'slugged' and the extension '.md'.
If you want to use the AI to suggest tags, install [Ollama](https://github.com/ollama/ollama) and run the following command:
```bash
ollama run mistral:7b-instruct-v0.2-q4_K_S
```
## License and credits
Frodown 2024 by [Jose Cerrejon](https://github.com/jmcerrejon) is licensed under [CC BY-NC 4.0](http://creativecommons.org/licenses/by-nc/4.0/?ref=chooser-v1)
I'm using _Conventional Commits v1.0.0_. More information can be found at https://www.conventionalcommits.org/en/v1.0.0/.
This repository is hosted at _GitHub_. You can find the repository at https://github.com/jmcerrejon/frodown
You can use it for free on your own. If you want to support me, you can!:
- 🪙 [paypal.me/jmcerrejon](https://paypal.me/jmcerrejon)
- ☕️ [ko-fi.com > Buy me a coffee](https://ko-fi.com/cerrejon)
- 🟡 Bitcoin: 32XtfF8eKkWkAGJsHvBsjqsted5NKsGBcv