diff --git a/CHANGELOG.md b/CHANGELOG.md
index cffdc350..8a5f5809 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,9 @@
 
 ## Unreleased
 
+### Added
+- Add `--doc [search]` option
+
 ### Fixed
 - Stop executing remaining commands in `set_up`/`tear_down` after first failure
 - Count all tests as failed when `set_up_before_script` fails
diff --git a/bashunit b/bashunit
index 4256384b..5835985d 100755
--- a/bashunit
+++ b/bashunit
@@ -52,6 +52,7 @@ source "$BASHUNIT_ROOT_DIR/src/helpers.sh"
 source "$BASHUNIT_ROOT_DIR/src/test_title.sh"
 source "$BASHUNIT_ROOT_DIR/src/upgrade.sh"
 source "$BASHUNIT_ROOT_DIR/src/assertions.sh"
+source "$BASHUNIT_ROOT_DIR/src/doc.sh"
 source "$BASHUNIT_ROOT_DIR/src/reports.sh"
 source "$BASHUNIT_ROOT_DIR/src/runner.sh"
 source "$BASHUNIT_ROOT_DIR/src/bashunit.sh"
@@ -129,6 +130,15 @@ while [[ $# -gt 0 ]]; do
       console_header::print_version
       trap '' EXIT && exit 0
       ;;
+    --doc)
+      if [[ -n ${2:-} && ${2:0:1} != "-" ]]; then
+        doc::print_asserts "$2"
+        shift
+      else
+        doc::print_asserts
+      fi
+      trap '' EXIT && exit 0
+      ;;
     --upgrade)
       upgrade::upgrade
       trap '' EXIT && exit 0
diff --git a/build.sh b/build.sh
index 652db79c..6fa06225 100755
--- a/build.sh
+++ b/build.sh
@@ -48,6 +48,9 @@ function build::generate_bin() {
   grep -v '^source' "$temp" > "$out"
   rm "$temp"
   chmod u+x "$out"
+
+  # Embed the assertions.md docs into the binary
+  build::embed_docs "$out"
 }
 
 # Recursive function to process each file and any files it sources
@@ -105,6 +108,7 @@ function build::dependencies() {
     "src/runner.sh"
     "src/init.sh"
     "src/learn.sh"
+    "src/doc.sh"
     "src/bashunit.sh"
     "src/main.sh"
   )
@@ -112,6 +116,31 @@ function build::dependencies() {
   echo "${deps[@]}"
 }
 
+function build::embed_docs() {
+  local file=$1
+  local docs_file="docs/assertions.md"
+  local temp_file="${file}.tmp"
+
+  # Build the replacement content
+  {
+    # Print everything before the start marker (excluding the marker line)
+    local line_num
+    line_num=$(grep -n "# __BASHUNIT_EMBEDDED_DOCS_START__" "$file" | cut -d: -f1)
+    head -n "$((line_num - 1))" "$file"
+
+    # Print the heredoc with embedded docs
+    echo "  cat <<'__BASHUNIT_DOCS_EOF__'"
+    cat "$docs_file"
+    echo "__BASHUNIT_DOCS_EOF__"
+
+    # Print everything after the end marker
+    sed -n '/# __BASHUNIT_EMBEDDED_DOCS_END__/,$p' "$file" | tail -n +2
+  } > "$temp_file"
+
+  mv "$temp_file" "$file"
+  chmod u+x "$file"
+}
+
 function build::generate_checksum() {
   local out=$1
 
diff --git a/docs/assertions.md b/docs/assertions.md
index 4461b656..9aca937e 100644
--- a/docs/assertions.md
+++ b/docs/assertions.md
@@ -113,7 +113,7 @@ function test_failure() {
 
 Reports an error if `needle` is not a substring of `haystack`.
 
-[assert_not_contains](#assert-not-contains) is the inverse of this assertion and takes the same arguments.
+- [assert_not_contains](#assert-not-contains) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -150,7 +150,7 @@ function test_failure() {
 
 Reports an error if `actual` is not empty.
 
-[assert_not_empty](#assert-not-empty) is the inverse of this assertion and takes the same arguments.
+- [assert_not_empty](#assert-not-empty) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -169,7 +169,7 @@ function test_failure() {
 
 Reports an error if `value` does not match the regular expression `pattern`.
 
-[assert_not_matches](#assert-not-matches) is the inverse of this assertion and takes the same arguments.
+- [assert_not_matches](#assert-not-matches) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -188,7 +188,7 @@ function test_failure() {
 
 Reports an error if `haystack` does not starts with `needle`.
 
-[assert_string_not_starts_with](#assert-string-not-starts-with) is the inverse of this assertion and takes the same arguments.
+- [assert_string_not_starts_with](#assert-string-not-starts-with) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -207,7 +207,7 @@ function test_failure() {
 
 Reports an error if `haystack` does not ends with `needle`.
 
-[assert_string_not_ends_with](#assert-string-not-ends-with) is the inverse of this assertion and takes the same arguments.
+- [assert_string_not_ends_with](#assert-string-not-ends-with) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -247,7 +247,7 @@ function test_failure() {
 
 Reports an error if `actual` is not less than `expected`.
 
-[assert_greater_than](#assert-greater-than) is the inverse of this assertion and takes the same arguments.
+- [assert_greater_than](#assert-greater-than) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -266,7 +266,7 @@ function test_failure() {
 
 Reports an error if `actual` is not less than or equal to `expected`.
 
-[assert_greater_than](#assert-greater-or-equal-than) is the inverse of this assertion and takes the same arguments.
+- [assert_greater_than](#assert-greater-or-equal-than) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -289,7 +289,7 @@ function test_failure() {
 
 Reports an error if `actual` is not greater than `expected`.
 
-[assert_less_than](#assert-less-than) is the inverse of this assertion and takes the same arguments.
+- [assert_less_than](#assert-less-than) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -308,7 +308,7 @@ function test_failure() {
 
 Reports an error if `actual` is not greater than or equal to `expected`.
 
-[assert_less_or_equal_than](#assert-less-or-equal-than) is the inverse of this assertion and takes the same arguments.
+- [assert_less_or_equal_than](#assert-less-or-equal-than) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -333,7 +333,7 @@ Reports an error if the exit code of `callable` is not equal to `expected`.
 
 If `callable` is not provided, it takes the last executed command or function instead.
 
-[assert_successful_code](#assert-successful-code), [assert_unsuccessful_code](#assert-unsuccessful-code), [assert_general_error](#assert-general-error) and [assert_command_not_found](#assert-command-not-found)
+- [assert_successful_code](#assert-successful-code), [assert_unsuccessful_code](#assert-unsuccessful-code), [assert_general_error](#assert-general-error) and [assert_command_not_found](#assert-command-not-found)
 are more semantic versions of this assertion, for which you don't need to specify an exit code.
 
 ::: code-group
@@ -396,7 +396,7 @@ function test_failure() {
 
 Reports an error if `needle` is not an element of `haystack`.
 
-[assert_array_not_contains](#assert-array-not-contains) is the inverse of this assertion and takes the same arguments.
+- [assert_array_not_contains](#assert-array-not-contains) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -421,7 +421,7 @@ Reports an error if the exit code of `callable` is not successful (`0`).
 
 If `callable` is not provided, it takes the last executed command or function instead.
 
-[assert_exit_code](#assert-exit-code) is the full version of this assertion where you can specify the expected exit code.
+- [assert_exit_code](#assert-exit-code) is the full version of this assertion where you can specify the expected exit code.
 
 ::: code-group
 ```bash [Example]
@@ -499,7 +499,7 @@ Reports an error if the exit code of `callable` is not a general error (`1`).
 
 If `callable` is not provided, it takes the last executed command or function instead.
 
-[assert_exit_code](#assert-exit-code) is the full version of this assertion where you can specify the expected exit code.
+- [assert_exit_code](#assert-exit-code) is the full version of this assertion where you can specify the expected exit code.
 
 ::: code-group
 ```bash [Example]
@@ -539,7 +539,7 @@ In other words, if executing `callable` does not return a command not found exit
 
 If `callable` is not provided, it takes the last executed command or function instead.
 
-[assert_exit_code](#assert-exit-code) is the full version of this assertion where you can specify the expected exit code.
+- [assert_exit_code](#assert-exit-code) is the full version of this assertion where you can specify the expected exit code.
 
 ::: code-group
 ```bash [Example]
@@ -564,7 +564,7 @@ function test_failure() {
 
 Reports an error if `file` does not exists, or it is a directory.
 
-[assert_file_not_exists](#assert-file-not-exists) is the inverse of this assertion and takes the same arguments.
+- [assert_file_not_exists](#assert-file-not-exists) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -590,7 +590,7 @@ function test_failure() {
 
 Reports an error if `file` does not contains the search string.
 
-[assert_file_not_contains](#assert-file-not-contains) is the inverse of this assertion and takes the same arguments.
+- [assert_file_not_contains](#assert-file-not-contains) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -665,7 +665,7 @@ function test_failure() {
 
 Reports an error if `directory` does not exist.
 
-[assert_directory_not_exists](#assert-directory-not-exists) is the inverse of this assertion and takes the same arguments.
+- [assert_directory_not_exists](#assert-directory-not-exists) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -709,7 +709,7 @@ function test_failure() {
 
 Reports an error if `directory` is not an empty directory.
 
-[assert_is_directory_not_empty](#assert-is-directory-not-empty) is the inverse of this assertion and takes the same arguments.
+- [assert_is_directory_not_empty](#assert-is-directory-not-empty) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -733,7 +733,7 @@ function test_failure() {
 
 Reports an error if `directory` is not a readable directory.
 
-[assert_is_directory_not_readable](#assert-is-directory-not-readable) is the inverse of this assertion and takes the same arguments.
+- [assert_is_directory_not_readable](#assert-is-directory-not-readable) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -757,7 +757,7 @@ function test_failure() {
 
 Reports an error if `directory` is not a writable directory.
 
-[assert_is_directory_not_writable](#assert-is-directory-not-writable) is the inverse of this assertion and takes the same arguments.
+- [assert_is_directory_not_writable](#assert-is-directory-not-writable) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -781,7 +781,7 @@ function test_failure() {
 
 Reports an error if `expected` and `actual` are not equals.
 
-[assert_files_not_equals](#assert-files-not-equals) is the inverse of this assertion and takes the same arguments.
+- [assert_files_not_equals](#assert-files-not-equals) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -821,7 +821,7 @@ function test_failure() {
 
 Reports an error if the two variables `expected` and `actual` are the same value.
 
-[assert_same](#assert-same) is the inverse of this assertion and takes the same arguments.
+- [assert_same](#assert-same) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -840,7 +840,7 @@ function test_failure() {
 
 Reports an error if `needle` is a substring of `haystack`.
 
-[assert_contains](#assert-contains) is the inverse of this assertion and takes the same arguments.
+- [assert_contains](#assert-contains) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -859,7 +859,7 @@ function test_failure() {
 
 Reports an error if `haystack` does starts with `needle`.
 
-[assert_string_starts_with](#assert-string-starts-with) is the inverse of this assertion and takes the same arguments.
+- [assert_string_starts_with](#assert-string-starts-with) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -878,7 +878,7 @@ function test_failure() {
 
 Reports an error if `haystack` does ends with `needle`.
 
-[assert_string_ends_with](#assert-string-ends-with) is the inverse of this assertion and takes the same arguments.
+- [assert_string_ends_with](#assert-string-ends-with) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -897,7 +897,7 @@ function test_failure() {
 
 Reports an error if `actual` is empty.
 
-[assert_empty](#assert-empty) is the inverse of this assertion and takes the same arguments.
+- [assert_empty](#assert-empty) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -916,7 +916,7 @@ function test_failure() {
 
 Reports an error if `value` matches the regular expression `pattern`.
 
-[assert_matches](#assert-matches) is the inverse of this assertion and takes the same arguments.
+- [assert_matches](#assert-matches) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -935,7 +935,7 @@ function test_failure() {
 
 Reports an error if `needle` is an element of `haystack`.
 
-[assert_array_contains](#assert-array-contains) is the inverse of this assertion and takes the same arguments.
+- [assert_array_contains](#assert-array-contains) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -958,7 +958,7 @@ function test_failure() {
 
 Reports an error if `file` does exists.
 
-[assert_file_exists](#assert-file-exists) is the inverse of this assertion and takes the same arguments.
+- [assert_file_exists](#assert-file-exists) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -985,7 +985,7 @@ function test_failed() {
 
 Reports an error if `file` contains the search string.
 
-[assert_file_contains](#assert-file-contains) is the inverse of this assertion and takes the same arguments.
+- [assert_file_contains](#assert-file-contains) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -1010,7 +1010,7 @@ function test_failure() {
 
 Reports an error if `directory` exists.
 
-[assert_directory_exists](#assert-directory-exists) is the inverse of this assertion and takes the same arguments.
+- [assert_directory_exists](#assert-directory-exists) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -1033,7 +1033,7 @@ function test_failure() {
 
 Reports an error if `directory` is empty.
 
-[assert_is_directory_empty](#assert-is-directory-empty) is the inverse of this assertion and takes the same arguments.
+- [assert_is_directory_empty](#assert-is-directory-empty) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -1057,7 +1057,7 @@ function test_failure() {
 
 Reports an error if `directory` is readable.
 
-[assert_is_directory_readable](#assert-is-directory-readable) is the inverse of this assertion and takes the same arguments.
+- [assert_is_directory_readable](#assert-is-directory-readable) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -1081,7 +1081,7 @@ function test_failure() {
 
 Reports an error if `directory` is writable.
 
-[assert_is_directory_writable](#assert-is-directory-writable) is the inverse of this assertion and takes the same arguments.
+- [assert_is_directory_writable](#assert-is-directory-writable) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
@@ -1106,7 +1106,7 @@ function test_failure() {
 
 Reports an error if `expected` and `actual` are not equals.
 
-[assert_files_equals](#assert-files-equals) is the inverse of this assertion and takes the same arguments.
+- [assert_files_equals](#assert-files-equals) is the inverse of this assertion and takes the same arguments.
 
 ::: code-group
 ```bash [Example]
diff --git a/docs/command-line.md b/docs/command-line.md
index 15cb6883..6a10cc12 100644
--- a/docs/command-line.md
+++ b/docs/command-line.md
@@ -382,6 +382,26 @@ Upgrade **bashunit** to latest version.
 ```
 :::
 
+## Doc
+
+> `bashunit --doc [filter]`
+
+Display the documentation for assert functions. When `filter` is provided,
+only matching asserts will be shown.
+
+::: code-group
+```bash [Example]
+./bashunit --doc same
+```
+```bash [Output]
+## assert_equals
+...
+
+## assert_not_same
+...
+```
+:::
+
 ## Init
 
 > `bashunit --init [dir]`
diff --git a/src/console_header.sh b/src/console_header.sh
index bce247d2..3d03e9dd 100644
--- a/src/console_header.sh
+++ b/src/console_header.sh
@@ -79,6 +79,10 @@ Options:
   --debug [file]
                             Enable shell debug mode. Logs to file if provided.
 
+  --doc <?filter>
+                            Display the documentation for assert functions. When a filter is
+                            provided, only matching asserts will be shown.
+
   -e, --env, --boot <file>
                             Load a custom env/bootstrap file to override .env or define globals.
 
diff --git a/src/doc.sh b/src/doc.sh
new file mode 100644
index 00000000..cf33cc17
--- /dev/null
+++ b/src/doc.sh
@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+
+# This function returns the embedded assertions.md content.
+# During development, it reads from the file.
+# During build, this function is replaced with actual content.
+function doc::get_embedded_docs() {
+  # __BASHUNIT_EMBEDDED_DOCS_START__
+  cat "$BASHUNIT_ROOT_DIR/docs/assertions.md"
+  # __BASHUNIT_EMBEDDED_DOCS_END__
+}
+
+function doc::print_asserts() {
+  local filter="${1:-}"
+  local line
+  local docstring=""
+  local fn=""
+  local should_print=0
+
+  while IFS='' read -r line || [[ -n "$line" ]]; do
+    if [[ $line =~ ^##\ ([A-Za-z0-9_]+) ]]; then
+      fn="${BASH_REMATCH[1]}"
+      if [[ -z "$filter" || "$fn" == *"$filter"* ]]; then
+        should_print=1
+        echo "$line"
+        docstring=""
+      else
+        should_print=0
+      fi
+      continue
+    fi
+
+    if (( should_print )); then
+      if [[ "$line" =~ ^\`\`\` ]]; then
+        echo "--------------"
+        echo "$docstring"
+        should_print=0
+        continue
+      fi
+
+      [[ "$line" == "::: code-group"* ]] && continue
+
+      # Remove markdown link brackets and anchor tags
+      line="${line//[\[\]]/}"
+      line="$(sed -E 's/ *\(#[-a-z0-9]+\)//g' <<< "$line")"
+      docstring+="$line"$'\n'
+    fi
+  done <<< "$(doc::get_embedded_docs)"
+}
diff --git a/tests/acceptance/bashunit_test.sh b/tests/acceptance/bashunit_test.sh
index f5103cbe..a1b749a5 100644
--- a/tests/acceptance/bashunit_test.sh
+++ b/tests/acceptance/bashunit_test.sh
@@ -18,3 +18,41 @@ function test_bashunit_should_display_help() {
   assert_match_snapshot "$(./bashunit --no-parallel --env "$TEST_ENV_FILE" --help)"
   assert_successful_code "$(./bashunit --no-parallel --env "$TEST_ENV_FILE" --help)"
 }
+
+function test_bashunit_should_display_all_assert_docs() {
+  assert_match_snapshot "$(./bashunit --no-parallel --env "$TEST_ENV_FILE" --doc)"
+  assert_successful_code "$(./bashunit --no-parallel --env "$TEST_ENV_FILE" --doc)"
+}
+
+function test_bashunit_should_display_filtered_assert_docs() {
+  assert_match_snapshot "$(./bashunit --no-parallel --env "$TEST_ENV_FILE" --doc equals)"
+  assert_successful_code "$(./bashunit --no-parallel --env "$TEST_ENV_FILE" --doc equals)"
+}
+
+function test_built_binary_should_display_docs_without_file_access() {
+  if [[ ! -f "bin/bashunit" ]]; then
+    skip "Built binary not found - run ./build.sh first"
+    return
+  fi
+
+  local output
+  output=$(bin/bashunit --doc assert_true 2>&1)
+
+  assert_successful_code
+  assert_contains "assert_true" "$output"
+  assert_contains "bool|function|command" "$output"
+}
+
+function test_built_binary_docs_should_match_dev_docs() {
+  if [[ ! -f "bin/bashunit" ]]; then
+    skip "Built binary not found - run ./build.sh first"
+    return
+  fi
+
+  local dev_output built_output
+
+  dev_output=$(./bashunit --no-parallel --env "$TEST_ENV_FILE" --doc equals)
+  built_output=$(bin/bashunit --doc equals)
+
+  assert_same "$dev_output" "$built_output"
+}
diff --git a/tests/acceptance/snapshots/bashunit_path_test_sh.test_bashunit_without_path_env_nor_argument.snapshot b/tests/acceptance/snapshots/bashunit_path_test_sh.test_bashunit_without_path_env_nor_argument.snapshot
index dd2d5bc8..16a15af4 100644
--- a/tests/acceptance/snapshots/bashunit_path_test_sh.test_bashunit_without_path_env_nor_argument.snapshot
+++ b/tests/acceptance/snapshots/bashunit_path_test_sh.test_bashunit_without_path_env_nor_argument.snapshot
@@ -19,6 +19,10 @@ Options:
   --debug [file]
                             Enable shell debug mode. Logs to file if provided.
 
+  --doc <?filter>
+                            Display the documentation for assert functions. When a filter is
+                            provided, only matching asserts will be shown.
+
   -e, --env, --boot <file>
                             Load a custom env/bootstrap file to override .env or define globals.
 
diff --git a/tests/acceptance/snapshots/bashunit_test_sh.test_bashunit_should_display_all_assert_docs.snapshot b/tests/acceptance/snapshots/bashunit_test_sh.test_bashunit_should_display_all_assert_docs.snapshot
new file mode 100644
index 00000000..e2204851
--- /dev/null
+++ b/tests/acceptance/snapshots/bashunit_test_sh.test_bashunit_should_display_all_assert_docs.snapshot
@@ -0,0 +1,179 @@
+## assert_true
+--------------
+::ignore::
+
+## assert_false
+--------------
+::ignore::
+
+## assert_same
+--------------
+::ignore::
+
+## assert_equals
+--------------
+::ignore::
+
+## assert_contains
+--------------
+::ignore::
+
+## assert_contains_ignore_case
+--------------
+::ignore::
+
+## assert_empty
+--------------
+::ignore::
+
+## assert_matches
+--------------
+::ignore::
+
+## assert_string_starts_with
+--------------
+::ignore::
+
+## assert_string_ends_with
+--------------
+::ignore::
+
+## assert_line_count
+--------------
+::ignore::
+
+## assert_less_than
+--------------
+::ignore::
+
+## assert_less_or_equal_than
+--------------
+::ignore::
+
+## assert_greater_than
+--------------
+::ignore::
+
+## assert_greater_or_equal_than
+--------------
+::ignore::
+
+## assert_exit_code
+--------------
+::ignore::
+
+## assert_array_contains
+--------------
+::ignore::
+
+## assert_successful_code
+--------------
+::ignore::
+
+## assert_general_error
+--------------
+::ignore::
+
+## assert_command_not_found
+--------------
+::ignore::
+
+## assert_file_exists
+--------------
+::ignore::
+
+## assert_file_contains
+--------------
+::ignore::
+
+## assert_is_file
+--------------
+::ignore::
+
+## assert_is_file_empty
+--------------
+::ignore::
+
+## assert_directory_exists
+--------------
+::ignore::
+
+## assert_is_directory
+--------------
+::ignore::
+
+## assert_is_directory_empty
+--------------
+::ignore::
+
+## assert_is_directory_readable
+--------------
+::ignore::
+
+## assert_is_directory_writable
+--------------
+::ignore::
+
+## assert_files_equals
+--------------
+::ignore::
+
+## assert_not_same
+--------------
+::ignore::
+
+## assert_not_contains
+--------------
+::ignore::
+
+## assert_string_not_starts_with
+--------------
+::ignore::
+
+## assert_string_not_ends_with
+--------------
+::ignore::
+
+## assert_not_empty
+--------------
+::ignore::
+
+## assert_not_matches
+--------------
+::ignore::
+
+## assert_array_not_contains
+--------------
+::ignore::
+
+## assert_file_not_exists
+--------------
+::ignore::
+
+## assert_file_not_contains
+--------------
+::ignore::
+
+## assert_directory_not_exists
+--------------
+::ignore::
+
+## assert_is_directory_not_empty
+--------------
+::ignore::
+
+## assert_is_directory_not_readable
+--------------
+::ignore::
+
+## assert_is_directory_not_writable
+--------------
+::ignore::
+
+## assert_files_not_equals
+--------------
+::ignore::
+
+## fail
+--------------
+::ignore::
diff --git a/tests/acceptance/snapshots/bashunit_test_sh.test_bashunit_should_display_filtered_assert_docs.snapshot b/tests/acceptance/snapshots/bashunit_test_sh.test_bashunit_should_display_filtered_assert_docs.snapshot
new file mode 100644
index 00000000..63c6ee31
--- /dev/null
+++ b/tests/acceptance/snapshots/bashunit_test_sh.test_bashunit_should_display_filtered_assert_docs.snapshot
@@ -0,0 +1,25 @@
+## assert_equals
+--------------
+> `assert_equals "expected" "actual"`
+
+Reports an error if the two variables `expected` and `actual` are not equal ignoring the special chars like ANSI Escape Sequences (colors) and other special chars like tabs and new lines.
+
+- assert_same is similar but including special chars.
+
+
+## assert_files_equals
+--------------
+> `assert_files_equals "expected" "actual"`
+
+Reports an error if `expected` and `actual` are not equals.
+
+- assert_files_not_equals is the inverse of this assertion and takes the same arguments.
+
+
+## assert_files_not_equals
+--------------
+> `assert_files_not_equals "expected" "actual"`
+
+Reports an error if `expected` and `actual` are not equals.
+
+- assert_files_equals is the inverse of this assertion and takes the same arguments.
diff --git a/tests/acceptance/snapshots/bashunit_test_sh.test_bashunit_should_display_help.snapshot b/tests/acceptance/snapshots/bashunit_test_sh.test_bashunit_should_display_help.snapshot
index 3e106bb6..8974e255 100644
--- a/tests/acceptance/snapshots/bashunit_test_sh.test_bashunit_should_display_help.snapshot
+++ b/tests/acceptance/snapshots/bashunit_test_sh.test_bashunit_should_display_help.snapshot
@@ -18,6 +18,10 @@ Options:
   --debug [file]
                             Enable shell debug mode. Logs to file if provided.
 
+  --doc <?filter>
+                            Display the documentation for assert functions. When a filter is
+                            provided, only matching asserts will be shown.
+
   -e, --env, --boot <file>
                             Load a custom env/bootstrap file to override .env or define globals.