Skip to content

xbais/minimark

Folders and files

NameName
Last commit message
Last commit date

Latest commit

455e27a Β· Feb 10, 2025

History

67 Commits
Nov 2, 2024
Nov 2, 2024
Nov 25, 2024
Nov 22, 2024
Nov 25, 2024
Nov 25, 2024
Nov 25, 2024
Oct 30, 2024
Nov 1, 2024
Feb 10, 2025
Nov 1, 2024
Nov 25, 2024

Repository files navigation

🌟 MiniMark 🌟 : The CLI Markdown Editor / Viewer

The FIRST Command-line markdown editor which can display IMAGES! πŸ–ΌοΈπŸ“Έ

OS Python Version License version

Sublime's custom image

Light Mode Dark Mode Markdown Editor

πŸ”· Installation of Pre-requisites

  1. Install NVM Package Manager :
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
  1. Install Pupetteer :
npx puppeteer browsers install chrome-headless-shell
  1. Install Mermaid CLI :
npm install -g @mermaid-js/mermaid-cli
  1. Install Ripgrep Utility :
sudo apt install ripgrep
  1. Install Kitty :
sudo apt install kitty

πŸ”· Installation & Usage

  • For Ubuntu < 24.04 LTS : pip3 install minimark
  • For Ubuntu == 24.04 LTS : pip3 install minimark --break-system-packages (NOTE : Ubuntu 24 does not allow installing any python packages without the additional flag, but rest assured : IT IS SAFE, if you dont want this, you can install Minimark in a separate Python venv)

Usage

To open a markdown file with minimark, simply...

  1. Open the Kitty terminal emulator.
  2. Within Kitty, use the command : minimark -file /location/to/my_markdown_file.md

πŸ”· Features

(🟒 = Impemented, πŸ”΅ = May work, but hasn't been tested, 🟠 = Upcoming)

  • Dark mode support 🟒
  • ⭐ Latex support 🟒
  • ⭐ Mermaid Diagram Support 🟒
  • Windows Support πŸ”΅ (#19)
  • TODO support 🟠
  • Git versioning support 🟠
  • Export to other formats (PDF / Word / HTML / Latex) 🟠
  • Rich Email support 🟠
  • Online File Sync 🟠
  • Online collaboration 🟠
  • SSH support (can work over SSH) πŸ”΅
  • Support for emoji short-codes 🟒
  • Zotero support 🟠
  • TTS support 🟒 (Basic #16)
  • Hand-drawing support 🟠 (Excalidraw)
  • 🌟 ChatGPT and Generative AI integration

πŸ”· Links

About

MiniMark : The CLI Markdown Editor / Viewer

Resources

License

Stars

Watchers

Forks

Packages

No packages published