@@ -33,6 +33,11 @@ impl crate::cmd::Command for CmdAlias {
 }
 
 /// Delete an alias.
+///
+/// ```shell
+/// zoo alias delete aabb_mm
+/// ```
+///
 #[derive(Parser, Debug, Clone)]
 #[clap(verbatim_doc_comment)]
 pub struct CmdAliasDelete {
@@ -88,6 +93,13 @@ impl crate::cmd::Command for CmdAliasDelete {
 /// If the expansion starts with "!" or if "--shell" was given, the expansion is a shell
 /// expression that will be evaluated through the "sh" interpreter when the alias is
 /// invoked. This allows for chaining multiple commands via piping and redirection.
+///
+///
+/// ```shell
+/// zoo alias set aabb_mm "kcl bounding-box $1 --output-unit mm"
+/// zoo aabb_mm my-file.kcl
+/// ```
+///
 #[derive(Parser, Debug, Clone)]
 #[clap(verbatim_doc_comment)]
 pub struct CmdAliasSet {
@@ -169,6 +181,10 @@ impl crate::cmd::Command for CmdAliasSet {
 
 /// List your aliases.
 ///
+/// ```shell
+/// zoo alias list
+/// ```
+///
 /// This command prints out all of the aliases `zoo` is configured to use.
 #[derive(Parser, Debug, Clone)]
 #[clap(verbatim_doc_comment)]
 
@@ -4,8 +4,13 @@ use itertools::Itertools;
 
 /// Perform operations on CAD files.
 ///
-///     # convert a step file to an obj file
-///     $ zoo file convert ./input.step ./output.obj
+/// A file conversion under 25MB will not have a zoo api-call status. The requested id will return 404.
+///   
+/// ```shell
+/// # convert a step file to an obj file
+/// zoo file convert ~/Downloads/cube.step ~/Downloads --output-format obj
+/// ```
+///
 #[derive(Parser, Debug, Clone)]
 #[clap(verbatim_doc_comment)]
 pub struct CmdApiCall {
@@ -29,8 +34,10 @@ impl crate::cmd::Command for CmdApiCall {
 
 /// Perform operations for API calls.
 ///
-///     # get the status of an async API call
-///    `$ zoo api-call status <id>`
+/// ```shell
+/// # get the status of an async API call
+/// zoo api-call status <id>
+/// ```
 #[derive(Parser, Debug, Clone)]
 #[clap(verbatim_doc_comment)]
 pub struct CmdApiCallStatus {
 
@@ -15,11 +15,18 @@ an issue at https://github.com/KittyCAD/cli/issues/new"#;
 ///
 /// If you do not have the app installed, you will be prompted to download it.
 ///
-///     $ zoo app .
+/// ```shell
+/// zoo app .
+/// ```
 ///
-///     $ zoo app main.kcl
+/// ```shell
+/// zoo app main.kcl
+/// ```
+///
+/// ```shell
+/// zoo app ../main.kcl
+/// ```
 ///
-///     $ zoo app ../main.kcl
 #[derive(Parser, Debug, Clone)]
 #[clap(verbatim_doc_comment)]
 pub struct CmdApp {
 
@@ -84,17 +84,26 @@ pub fn parse_host(input: &str) -> Result<url::Url> {
 ///
 /// Alternatively, pass in a token on standard input by using `--with-token`.
 ///
-///     # start interactive setup
-///     $ zoo auth login
+/// ```shell
+/// # start interactive setup
+/// zoo auth login
+/// ```
 ///
-///     # authenticate against a specific Zoo instance by reading the token from a file
-///     $ zoo --host zoo.internal auth login --with-token < mytoken.txt
+/// ```shell
+/// # authenticate against a specific Zoo instance by reading the token from a file
+/// zoo --host api.zoo.dev auth login --with-token < mytoken.txt
+/// ```
 ///
-///     # authenticate with a specific Zoo instance
-///     $ zoo --host zoo.internal auth login
+/// ```shell
+/// # authenticate with a specific Zoo instance
+/// zoo --host api.zoo.dev auth login
+/// ```
 ///
-///     # authenticate with an insecure Zoo instance (not recommended)
-///     $ zoo --host http://zoo.internal auth login
+/// ```shell
+/// # authenticate with an insecure Zoo instance (not recommended)
+/// zoo --host http://api.zoo.dev auth login
+/// ```
+///     
 #[derive(Parser, Debug, Clone)]
 #[clap(verbatim_doc_comment)]
 pub struct CmdAuthLogin {
@@ -287,11 +296,17 @@ impl crate::cmd::Command for CmdAuthLogin {
 /// This command removes the authentication configuration for a host either specified
 /// interactively or via the global `--host` passed to `zoo`.
 ///
-///     $ zoo auth logout
-///     # => select what host to log out of via a prompt
 ///
-///     $ zoo --host zoo.internal auth logout
-///     # => log out of specified host
+/// ```shell
+/// zoo auth logout
+/// # => select what host to log out of via a prompt
+/// ```
+///
+/// ```shell
+/// zoo --host api.zoo.dev auth logout
+/// # => log out of specified host
+/// ```
+///
 #[derive(Parser, Debug, Clone)]
 #[clap(verbatim_doc_comment)]
 pub struct CmdAuthLogout {}
 
@@ -18,36 +18,49 @@ use clap_complete::{Shell, generate};
 ///
 /// After, add this to your `~/.bash_profile`:
 ///
-///     eval "$(zoo completion -s bash)"
-///
+/// ```shell
+/// eval "$(zoo completion -s bash)"
+/// ```
+///     
 /// ### zsh
 /// Generate a `_zoo` completion script and put it somewhere in your `$fpath`:
 ///
-///     zoo completion -s zsh > /usr/local/share/zsh/site-functions/_zoo
-///
+/// ```shell
+/// zoo completion -s zsh > /usr/local/share/zsh/site-functions/_zoo
+/// ```
+///     
 /// Ensure that the following is present in your `~/.zshrc`:
 ///
-///     autoload -U compinit
-///     compinit -i
+/// ```
+/// autoload -U compinit
+/// compinit -i
+/// ```
 ///
 /// Zsh version 5.7 or later is recommended.
 ///
 /// ### fish
 ///
 /// Generate a `zoo.fish` completion script:
 ///
-///     zoo completion -s fish > ~/.config/fish/completions/zoo.fish
-///
+/// ```shell
+///  zoo completion -s fish > ~/.config/fish/completions/zoo.fish
+/// ```
+///    
 /// ### PowerShell
 ///
 /// Open your profile script with:
 ///
-///     mkdir -Path (Split-Path -Parent $profile) -ErrorAction SilentlyContinue
-///     notepad $profile
+/// ```shell
+/// mkdir -Path (Split-Path -Parent $profile) -ErrorAction SilentlyContinue
+/// notepad $profile
+/// ```
 ///
 /// Add the line and save the file:
 ///
-///     Invoke-Expression -Command $(zoo completion -s powershell | Out-String)
+/// ```shell
+/// Invoke-Expression -Command $(zoo completion -s powershell | Out-String)
+/// ```
+///     
 #[derive(Parser, Debug, Clone)]
 #[clap(verbatim_doc_comment)]
 pub struct CmdCompletion {
 
@@ -15,8 +15,11 @@ use crate::cmd_kcl::write_deterministic_export;
 
 /// Perform operations on CAD files.
 ///
-///     # convert a step file to an obj file
-///     $ zoo file convert --output-format=obj ./input.step ./
+/// ```shell
+/// # convert a step file to an obj file
+/// zoo file convert --output-format=obj ./input.step ./
+/// ```
+///
 #[derive(Parser, Debug, Clone)]
 #[clap(verbatim_doc_comment)]
 pub struct CmdFile {
@@ -54,17 +57,25 @@ impl crate::cmd::Command for CmdFile {
 ///
 /// If the file being converted is larger than a certain size it will be
 /// performed asynchronously, you can then check its status with the
-/// `zoo api-call status <id_of_your_operation>` command.
+/// `zoo api-call status <id_of_your_operation>` command. The status call will return
+/// 404 if the size is under 25MB, it will not be processed asynchronously.
 ///
-///     # convert step to obj
-///     $ zoo file convert --output-format=obj my-file.step output_dir
+/// ```shell
+/// # convert step to obj
+/// zoo file convert --output-format=obj my-file.step output_dir
+/// ```
 ///
-///     # convert obj to step
-///     $ zoo file convert --output-format=step my-obj.obj .
+/// ```shell
+/// # convert obj to step
+/// zoo file convert --output-format=step my-obj.obj .
+/// ```
+///
+/// ```shell
+/// # pass a file to convert from stdin
+/// # when converting from stdin, the original file type is required
+/// cat my-obj.obj | zoo file convert --output-format=step --src-format=obj - output_dir
+/// ```
 ///
-///     # pass a file to convert from stdin
-///     # when converting from stdin, the original file type is required
-///     $ cat my-obj.obj | zoo file convert --output-format=step - output_dir
 #[derive(Parser, Debug, Clone)]
 #[clap(verbatim_doc_comment)]
 pub struct CmdFileConvert {
@@ -163,11 +174,16 @@ impl crate::cmd::Command for CmdFileConvert {
 
 /// Snapshot a render of a CAD file as any supported image format.
 ///
-///     # snapshot as png
-///     $ zoo file snapshot my-file.obj my-file.png
+/// ```shell
+/// # snapshot as png
+/// zoo file snapshot my-file.obj my-file.png
+/// ```
+///     
+/// ```shell
+/// # pass a file to snapshot from stdin
+/// cat my-obj.obj | zoo file snapshot --output-format=png --src-format=obj - my-file.png
+/// ```
 ///
-///     # pass a file to snapshot from stdin
-///     $ cat my-obj.obj | zoo file snapshot --output-format=png - my-file.png
 #[derive(Parser, Debug, Clone)]
 #[clap(verbatim_doc_comment)]
 pub struct CmdFileSnapshot {
@@ -370,11 +386,16 @@ impl crate::cmd::Command for CmdFileSnapshot {
 /// performed asynchronously, you can then check the status with the
 /// `zoo api-call status <id_of_your_operation>` command.
 ///
-///     # get the volume of a file
-///     $ zoo file volume my-file.step
+/// ```shell
+/// # get the volume of a file
+/// zoo file volume my-file.step --output-unit=mm3
+/// ```
 ///
-///     # pass a file from stdin, the original file type is required
-///     $ cat my-obj.obj | zoo file volume - --src-format=obj
+/// ```shell
+/// # pass a file from stdin, the original file type is required
+/// cat my-obj.obj | zoo file volume - --src-format=obj --output-unit=mm3
+/// ```
+///     
 #[derive(Parser, Debug, Clone)]
 #[clap(verbatim_doc_comment)]
 pub struct CmdFileVolume {
@@ -431,11 +452,16 @@ impl crate::cmd::Command for CmdFileVolume {
 /// performed asynchronously, you can then check the status with the
 /// `zoo api-call status <id_of_your_operation>` command.
 ///
-///     # get the mass of a file
-///     $ zoo file mass my-file.step
+/// ```shell
+/// # get the mass of a file
+/// zoo file mass my-file.step --material-density 500 --material-density-unit=kg-m3 --output-unit=kg
+/// ```
 ///
-///     # pass a file from stdin, the original file type is required
-///     $ cat my-obj.obj | zoo file mass - --src-format=obj
+/// ```shell
+/// # pass a file from stdin, the original file type is required
+/// cat my-obj.obj | zoo file mass - --src-format=obj --material-density 500 --material-density-unit=kg-m3 --output-unit=kg
+/// ```
+///     
 #[derive(Parser, Debug, Clone)]
 #[clap(verbatim_doc_comment)]
 pub struct CmdFileMass {
@@ -510,11 +536,16 @@ impl crate::cmd::Command for CmdFileMass {
 /// performed asynchronously, you can then check the status with the
 /// `zoo api-call status <id_of_your_operation>` command.
 ///
-///     # get the mass of a file
-///     $ zoo file center-of-mass my-file.step
+/// ```shell
+/// # get the mass of a file
+/// zoo file center-of-mass my-file.step --output-unit=m
+/// ```
 ///
-///     # pass a file from stdin, the original file type is required
-///     $ cat my-obj.obj | zoo file center-of-mass - --src-format=obj
+/// ```shell
+/// # pass a file from stdin, the original file type is required
+/// cat my-obj.obj | zoo file center-of-mass - --src-format=obj --output-unit=m
+/// ```
+///     
 #[derive(Parser, Debug, Clone)]
 #[clap(verbatim_doc_comment)]
 pub struct CmdFileCenterOfMass {
@@ -571,11 +602,16 @@ impl crate::cmd::Command for CmdFileCenterOfMass {
 /// performed asynchronously, you can then check the status with the
 /// `zoo api-call status <id_of_your_operation>` command.
 ///
-///     # get the density of a file
-///     $ zoo file density my-file.step
+/// ```shell
+/// # get the density of a file
+/// zoo file density my-file.step --material-mass 212.2923 --material-mass-unit g --output-unit kg-m3
+/// ```
+///
+/// ```shell
+/// # pass a file from stdin, the original file type is required
+/// cat my-obj.obj | zoo file density - --src-format=obj -material-mass 212.2923 --material-mass-unit g --output-unit kg-m3
+/// ```
 ///
-///     # pass a file from stdin, the original file type is required
-///     $ cat my-obj.obj | zoo file density - --src-format=obj
 #[derive(Parser, Debug, Clone)]
 #[clap(verbatim_doc_comment)]
 pub struct CmdFileDensity {
@@ -650,11 +686,16 @@ impl crate::cmd::Command for CmdFileDensity {
 /// performed asynchronously, you can then check the status with the
 /// `zoo api-call status <id_of_your_operation>` command.
 ///
-///     # get the surface-area of a file
-///     $ zoo file surface-area my-file.step
+/// ```shell
+/// # get the surface-area of a file
+/// zoo file surface-area my-file.step --output-unit m2
+/// ```
+///     
+/// ```shell
+/// # pass a file from stdin, the original file type is required
+/// cat my-obj.obj | zoo file surface-area - --src-format=obj --output-unit m2
+/// ```
 ///
-///     # pass a file from stdin, the original file type is required
-///     $ cat my-obj.obj | zoo file surface-area - --src-format=obj
 #[derive(Parser, Debug, Clone)]
 #[clap(verbatim_doc_comment)]
 pub struct CmdFileSurfaceArea {