Markdown-OS
Developer-focused markdown editor that runs as a local web server. Edit in the browser with live preview, Mermaid diagrams, syntax highlighting, and auto-save.
Desktop installers for macOS and Windows are published from GitHub Releases. The desktop app bundles the local server and opens with a picker-first workflow, so users do not need Python or a terminal after installation.
Install
pip install markdown-os
Or with uv:
uv tool install markdown-os
To upgrade after installing with uv: uv tool upgrade markdown-os
Desktop app
Download the latest desktop installers from GitHub Releases:
- macOS:
.dmg - Windows:
.exe
The desktop app keeps the same editor UI, but launches in a native desktop shell with recent files/folders and native open dialogs.
Usage
Single file:
markdown-os open ./notes.md
Directory (markdown workspace):
markdown-os open ./my-notes
The app opens in your browser. If port 8000 is in use, the next port is tried. Options: --host, --port.
Example file
Generate a showcase markdown file:
markdown-os example # creates example.md in current directory
markdown-os example ./docs/showcase.md # custom path
markdown-os example --open # generate and open in the editor
Use --force / -f to overwrite an existing file without prompting.
Publishing (maintainers)
Use the release helper from a clean working tree on the branch you want to publish (usually master):
uv run python scripts/release.py
It reads [project].version from pyproject.toml, asks whether to bump major, minor, or patch, updates the file, then runs git add / git commit (only pyproject.toml) / git push -u origin <current-branch> / annotated git tag / git push origin <tag>.
Useful options:
--dry-run— print the planned version and git steps without changing files or running git.-y/--yes— skip the final confirmation prompt.--version X.Y.Z— set an exact version string and skip the bump menu.--branch master— push a specific branch (defaults to your current branch).--repo /path/to/checkout— run against another clone.--allow-dirty— proceed when other files are modified (still only commitspyproject.toml).
Manual sequence (equivalent when you are on master):
- Bump
versioninpyproject.toml. - Commit and push:
git add pyproject.toml && git commit -m "chore: release X.Y.Z" && git push origin master - Tag and push:
git tag -a vX.Y.Z -m "Release X.Y.Z" && git push origin vX.Y.Z
The GitHub workflow runs on tag push and publishes to PyPI only when the tag matches the package version.
1 maintainer
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file markdown_os-1.2.0.tar.gz.
File metadata
- Download URL: markdown_os-1.2.0.tar.gz
- Upload date:
- Size: 6.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e0ca3b0888f7497d1ef346def5842cc2fcef8e8c9edd81432970972a51c5aa8e
|
|
| MD5 |
66766fe9c652950bbcb3d654b814c411
|
|
| BLAKE2b-256 |
92ecb89528a41dd4d48a4069e6e9836aafb475508eb346377f15529f8af6fbfc
|
Provenance
The following attestation bundles were made for markdown_os-1.2.0.tar.gz:
Publisher:
publish.yml on elena-cabrera/markdown-os
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
markdown_os-1.2.0.tar.gz -
Subject digest:
e0ca3b0888f7497d1ef346def5842cc2fcef8e8c9edd81432970972a51c5aa8e - Sigstore transparency entry: 2233881682
- Sigstore integration time:
-
Permalink:
elena-cabrera/markdown-os@2bc959a53868228bf0a4a93ba6313295babe978f -
Branch / Tag:
refs/tags/v1.2.0 - Owner: https://github.com/elena-cabrera
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@2bc959a53868228bf0a4a93ba6313295babe978f -
Trigger Event:
push
-
Statement type:
File details
Details for the file markdown_os-1.2.0-py3-none-any.whl.
File metadata
- Download URL: markdown_os-1.2.0-py3-none-any.whl
- Upload date:
- Size: 2.5 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d2ffc538839f0ea25da392bcc855e8b0cfc96aa5e98d8041b05b4352b5269f4c
|
|
| MD5 |
2ae1f1b68d1649c4dd5b6228328dc410
|
|
| BLAKE2b-256 |
20c55aa71d529e88ed988b8d050869877cbd6bbc62c729e8802111aaba20d94f
|
Provenance
The following attestation bundles were made for markdown_os-1.2.0-py3-none-any.whl:
Publisher:
publish.yml on elena-cabrera/markdown-os
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
markdown_os-1.2.0-py3-none-any.whl -
Subject digest:
d2ffc538839f0ea25da392bcc855e8b0cfc96aa5e98d8041b05b4352b5269f4c - Sigstore transparency entry: 2233882063
- Sigstore integration time:
-
Permalink:
elena-cabrera/markdown-os@2bc959a53868228bf0a4a93ba6313295babe978f -
Branch / Tag:
refs/tags/v1.2.0 - Owner: https://github.com/elena-cabrera
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@2bc959a53868228bf0a4a93ba6313295babe978f -
Trigger Event:
push
-
Statement type:
