md2nb
is a command-line tool for converting Markdown
files into Wolfram Notebooks.
md2nb
is a command-line tool. After installing md2nb
, it can be used
to convert a .md
file to a .nb
:
$ md2nb <INPUT>.md <OUTPUT>.nb
For example, to convert this project's README.md
file into a Wolfram Notebook, execute:
$ md2nb README.md README.nb
md2nb
converts .md
files into Wolfram .nb
files.
Markdown constructs are converted into corresponding standard Wolfram Notebook representations.
Most CommonMark features are supported, including:
- Text styles like emphasis and italics
- Links
- Headers
- Bulleted lists
- Code blocks
- Block quotes
- Tables
- Horizontal rules
Additionally, some Markdown features are converted into Wolfram Notebook representations that are more interactive than typical rendered Markdown:
- Code blocks containing code written in a language supported by
ExternalEvaluate
will be converted to external language cells, which can be executed directly within the Wolfram Notebook.
See the 'Kitchen Sink' example, which includes samples of all Markdown features
currently supported by md2nb
.
md2nb
can be installed using cargo
(the Rust package manager) by executing:
$ cargo install md2nb
This will install the latest version of md2nb
from crates.io.
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or https://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.