Skip to main content

NMdown

NMDown is a minimal terminal-based Markdown editor built with Python 3 and ncurses. It offers a clean editing experience with live syntax highlighting, autosave, and in-terminal search — all inside your terminal window.


Features

  • Markdown syntax highlighting (headers, bold, italic, code, lists, links, etc.)
  • Live character count in the footer
  • Header/footer UI with consistent styling
  • Autosave every 30 seconds with a .bak backup file
  • Flash message confirmation after autosave
  • In-editor search (Ctrl+F) with next (Ctrl+N) and previous (Ctrl+P) navigation
  • Safe cursor and rendering logic (handles terminal resizing and wide characters)

⌨️ Keybindings

Key Combo Action
Ctrl+S Save file
Ctrl+F Search
Ctrl+N Next match
Ctrl+P Previous match
Esc Exit editor
Arrow Keys Navigate cursor

Usage

You'll be prompted to enter a filename. If the file exists, it will be loaded. If not, a new file is created.


Installation

Install via pip

pip install mnmdown

Or clone from GitHub

git clone https://github.com/bearenbey/nmdown.git
cd nmdown
pip install .

# Run
nmdown

License

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see https://www.gnu.org/licenses/.

© 2025 Eren Öğrül termapp@pm.me

Metadata

Release files for nmdown 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nmdown 0.1.0
File Size Uploaded
nmdown-0.1.0.tar.gz 8.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for nmdown 0.1.0
File Interpreter ABI Platform
nmdown-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 16.7 kB

Release files / nmdown-0.1.0.tar.gz

Download URL nmdown-0.1.0.tar.gz
Size 8.5 kB
Tags Source
SHA-256 checksum
How to use checksums
8617f6add0f6abebda94aef4663029bf82b0e2d95e509b42545f6ec5442d6be1
BLAKE2b-256 checksum
How to use checksums
5eb8b0dfe234cac5c1d9f1e6be8f6250eef01000280ef498af233229edfa4b9d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.5

Release files / nmdown-0.1.0-py3-none-any.whl

Download URL nmdown-0.1.0-py3-none-any.whl
Size 8.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
85454d8fb803cfb4a3341c67952dbc63ef7449231bb676b9b3fd2ed2560420c5
BLAKE2b-256 checksum
How to use checksums
bfd7ade6aa9062b33f516380517a91d534e57b441fccb73ff435b1193d9dea35
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.5

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page