This ius a simple utility that allows you to generate working code from your markdown files. This is super early alpha so there's probably missing parts and it's a bit hacky.
Just put you code in your md file as usual marked with the language like:
```\rust
fn my_cool(stuff: ()) {
}
```
Then proceding that you mark it with the flag \#S: (yeh I know it's a weird marker but try finding something markdown doesn't use) and some tags.
INCLUDE All code blocks in your language proceeding this tag will be included in the generated code file.SKIP All code blocks in your language proceeding this tag will be not be included in the generated code file.EXTERNAL=path/to/file Include the code from this external file in the generated code file at this location.HIDE Hide only the next code block from showing up in the generate md file.bash
single_source code path/to/source.md path/to/code_file_to_be.generated lang
Example:
bash
single_source code path/to/my_tutorial.md path/to/lib.rs rust
bash
single_source md path/to/source.md path/to/md_file_to_be_generated.md
Example:
bash
single_source md path/to/my_tutorial_source.md path/to/finished_tutorial.md
#S:EXTERNAL=external.rs
(note this is actually \#S:EXTERNAL=external.rs but your md render might remove the \)
Some tutorial stuff
Some tutorial stuff
Some tutorial stuff
Skip this because it's just for information purposes and should not be included in the generate code file.
#S:SKIP ```rust // <---- Add the struct here.
mod something {
This code block also gets skipped.
rust
fn open() {}
```
This one will be included
#S:INCLUDE
rust
fn say() {
println!("hello");
}
also included
rust
fn say2() {
println!("hello2");
}
Going to hide the closing tag for the mod that we opened in external.rs
#S:HIDE
rust
}
rust
mod my_mod {