安装

其他安装命令

macOS

Homebrew已验证 · 100%

brew install mdsh

local Homebrew formula metadata

Linux

Fedora dnf已验证 · 92%

sudo dnf install mdsh

Fedora Rawhide package metadata · mdsh · 来源: dl.fedoraproject.org

Nix已验证 · 92%

nix profile install nixpkgs#mdsh

nixpkgs package indexes · pkgs/by-name/md/mdsh/package.nix · 来源: api.github.com

概览

软件包摘要

Markdown shell pre-processor

项目链接

命令和别名

mdsh

历史

项目历史与用法

mdsh is a Rust Markdown shell preprocessor that updates Markdown files in place by including files, executing commands, and refreshing generated blocks. The project describes itself as similar to literate programming or notebooks, but for shell commands in Markdown.

项目历史

The public repository was created on 2019-02-15. Its README explains the original problem as keeping README snippets, command output, and embedded file contents synchronized without manually copying text.

Unlike many preprocessors that emit a separate generated file, mdsh is designed around idempotent in-place updates. The README and project site document a compact Markdown extension for command blocks, comments, links, raw Markdown output, code-block output, and shell variable expansion.

采用历史

Official installation instructions recommend `cargo install mdsh`, Nix installation, Nix flakes, and use as a pre-commit hook. The input package-manager facts list Homebrew, dnf, and Nix packages.

GitHub metadata showed ongoing maintenance through 2026 and a modest but real open-source footprint, with repository topics around Markdown, pre-processing, and shell.

使用方式

By default, `mdsh` processes `./README.md`; `--inputs`, `--output`, and `--work-dir` let users choose files and execution directories. The `--frozen` mode is intended for CI checks that fail when generated documentation is stale.

The README documents commands for reading files, executing shell commands, producing raw Markdown or code blocks, expanding environment variables, cleaning generated blocks, and installing mdsh as a pre-commit hook.

为什么软件包爱好者会关心

mdsh matters to package-oriented developers because it turns a README into a reproducible build artifact without leaving Markdown. It is small, scriptable, CI-friendly, and sits in the same culture as literate shell docs, generated examples, and pre-commit-enforced documentation freshness.

时间线

2019: Public GitHub repository created.
2019: README license block identifies copyright for zimbatm and contributors.
2026: Repository metadata showed continued updates and availability through Cargo, Nix, Homebrew, and dnf-related packaging facts.

Related projects

The README compares mdsh with literate programming, Jupyter Notebooks, active code/Pandoc filters, and Enola.dev ExecMD.
The project deliberately chooses in-place Markdown updates rather than a separate rendered-document pipeline.

来源

https://api.github.com/repos/zimbatm/mdsh
https://github.com/zimbatm/mdsh#readme
https://zimbatm.github.io/mdsh/
source_facts.package-manager

安全态势

风险级别：yellow

generalized runtime or code generation signal.

风险分类器

yellow 风险 · 中置信度 · runtime

原因

generalized runtime or code generation signal

信号

text:shell

安装行为

formula 元数据中未记录 Homebrew post-install 钩子。
Homebrew bottle 元数据适用于 8 个平台目标。
构建元数据列出 1 个构建依赖。

建议审查

在无人值守的代理使用前，请检查该工具是否读取明文凭据、写入远程状态、发布制品或调用插件。

可执行文件

已安装的可执行文件

命令	类型	暴露范围	备注
`mdsh`	cli	全局可执行文件

新鲜度

版本和新鲜度

这些信号区分页生成时间、软件包管理器活动和上游发布比较。只有存在证据 URL 和可比较版本时，才会提示版本落后。

页面生成时间2026-07-08

管理器版本0.9.2

管理器更新时间

本地数据OK

上游当前

检测到的最新版本v0.9.2

https://github.com/zimbatm/mdsh

信息No package-manager update timestamp was available.低置信度

安装元数据

软件包元数据

软件包键	brew:mdsh
版本	0.9.2
软件包管理器	Homebrew
软件包管理器页面	https://formulae.brew.sh/formula/mdsh
主页	https://zimbatm.github.io/mdsh/
仓库	https://github.com/zimbatm/mdsh
上游文档	https://github.com/zimbatm/mdsh#readme
许可证	MIT
源码归档	https://github.com/zimbatm/mdsh/archive/refs/tags/v0.9.2.tar.gz
构建依赖	rust
Bottle	可用 (于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux)
Homebrew post-install	未定义
服务	未声明

注册表事实

源数据库详情

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	mdsh
Version Scheme	0
Revision	0
Head Version	HEAD
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	head stable

源数据库匹配

其他软件包管理器记录

匹配项来自外部软件包管理器索引，并与本地 Automic Vault 软件包链接分开显示。

Nix95%

mdsh

nix profile install nixpkgs#mdsh

normalized package name match
匹配方式：Mdsh

nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/md/mdsh/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

dnf95%

mdsh 0.7.0-8.fc44

Markdown shell pre-processor

https://crates.io/crates/mdsh

sudo dnf install mdsh

License: MIT AND Unicode-DFS-2016 AND (Apache-2.0 OR MIT) AND (Unlicense OR MIT)
Category: Unspecified
Architecture: x86_64
Source Package: rust-mdsh
4 依赖
1 提供
normalized package name match
匹配方式：Mdsh

Fedora Rawhide package metadata · dl.fedoraproject.org · Fedora Rawhide package metadata: mdsh from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

软件包图谱

链接来自本地软件包关系图、补充数据、依赖边、生态匹配和软件包 hub 归属。

来源线索

由仓库数据生成

此页面由 av-web 从 scripts/generate-pkg-sqlite.py 生成的私有软件包 SQLite 工件提供。

Combined YAML source

View the package source record on GitHub.

combined/mdsh.yml

使用的来源

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated package history
external package-manager database matches
package relationship graph
package version freshness
package-page enrichment

使用 Homebrew, dnf, Nix 安装 mdsh