Janklab's MlxShake is a tool to export Matlab Live Scripts (.mlx files) to Markdown and other formats. It can export to Markdown, HTML, PDF, Microsoft Word, and more.
This tool lets you generate project documentation and web site content from live scripts in your project. This is a nice way of generating rich documentation with included graphics that are up to date with your latest code.
Super quick examples:
From the shell or other programs:
./bin/mlxshake MyLiveScript.mlx --format html
MlxShake is based on, and started out as a fork of, MathWorker Michio Inoue's livescript2markdown tool. MlxShake can largely be viewed as a productization of livescript2markdown.
MlxShake adds the following enhancements over livescript2markdown:
- Automate the full process from .mlx to .md.
- Be suitable for use in automated document generation processes.
- Make the Markdown good enough that no manual touch-up is usually needed.
- Produce nicely-formatted output files.
- Support additional output formats.
MlxShake is licensed under a nonstandard MathWorks-specific variant of the BSD 2-Clause License that includes this additional clause:
* In all cases, the software is, and all modifications and derivatives of the software shall be, licensed to you solely for use in conjunction with MathWorks products and service offerings.
This is because the livescript2markdown project is licensed that way, and MlxShake contains derivatives of its code.