mdBook vs StepShot

mdBook is a free command-line tool for creating books from Markdown, including product and API documentation, tutorials, and course materials. It builds static output files in a book directory that can be transferred to a web service. Integrated search and syntax highlighting for code blocks help readers navigate and read examples, while theme files allow formatting changes. Preprocessors can add custom syntax or modify content; backends can render output to multiple formats. The `mdbook test` command tests Rust code samples in a book. Project documentation describes using GitHub Actions or GitLab CI/CD to test and deploy books automatically. Developers can also import mdBook libraries or use its plugin mechanism to build custom tooling and output backends. It runs on Linux, macOS, and Windows, and Markdown is its source input. Building from source requires Rust and Cargo, with Rust 1.88 as the stated minimum. The project directs issues and feature requests to its GitHub issue tracker and relies on community contributions for bug fixes and added features. The free, open-source plan is licensed under MPL-2.0.

StepShot is a macOS app that turns recorded workflows into step-by-step tutorials, standard operating procedures, and training documents. It captures activity through action-driven capture or screen recording, using cursor pauses as an additional cue for splitting recordings into steps. Users can edit steps and annotations, then export to PDF, Markdown, or HTML. Capture, editing, and all three export formats work locally without an internet connection. Optional AI assistance can suggest improvements to titles, descriptions, and step order; users review suggestions individually before applying them. Cloud planning requires a connection and a user-supplied OpenAI-compatible endpoint, API, and quota. The free plan costs nothing, allows unlimited capture and editing, and exports only the first 10 steps in Markdown or HTML. Pro costs 269 CNY, paid once and adds unlimited steps, PDF export, branding, optional cloud planning, and activation on two devices. Team costs 899 CNY, paid once and adds five-device activation, shared brand presets, bulk licensing, centralized invoicing, and priority feedback handling. StepShot requires macOS 14 or later and supports Apple Silicon and Intel.