diff --git a/.github/workflows/ubuntu.yml b/.github/workflows/ubuntu.yml
index 8f70f9586..1b477c9e5 100644
--- a/.github/workflows/ubuntu.yml
+++ b/.github/workflows/ubuntu.yml
@@ -147,3 +147,12 @@ jobs:
         run:  python -m pip install reuse
       - name: REUSE lint
         run: reuse lint
+
+  ci_test_documentation:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: cmake
+        run: cmake -S . -B build -DJSON_CI=On
+      - name: build
+        run: cmake --build build --target ci_test_documentation
diff --git a/cmake/ci.cmake b/cmake/ci.cmake
index e959edb56..0f74c3ea0 100644
--- a/cmake/ci.cmake
+++ b/cmake/ci.cmake
@@ -934,6 +934,16 @@ add_custom_target(ci_icpc
     COMMENT "Compile and test with ICPC"
 )
 
+###############################################################################
+# test documentation
+###############################################################################
+
+add_custom_target(ci_test_documentation
+    COMMAND make check_output_portable -j8
+    WORKING_DIRECTORY ${PROJECT_SOURCE_DIR}/docs
+    COMMENT "Check that all examples compile and create the desired output"
+)
+
 ###############################################################################
 # Clean up all generated files.
 ###############################################################################
diff --git a/docs/Makefile b/docs/Makefile
index 0de57e00f..37ff1418c 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -11,13 +11,13 @@ EXAMPLES = $(wildcard examples/*.cpp)
 
 # create output from a stand-alone example file
 %.output: %.cpp
-	make $(<:.cpp=) CPPFLAGS="-I $(SRCDIR)" CXXFLAGS="-std=c++11"
+	$(MAKE) $(<:.cpp=) CPPFLAGS="-I $(SRCDIR)" CXXFLAGS="-std=c++11"
 	./$(<:.cpp=) > $@
 	rm $(<:.cpp=)
 
 # compare created output with current output of the example files
 %.test: %.cpp
-	make $(<:.cpp=) CPPFLAGS="-I $(SRCDIR)" CXXFLAGS="-std=c++11"
+	$(MAKE) $(<:.cpp=) CPPFLAGS="-I $(SRCDIR)" CXXFLAGS="-std=c++11"
 	./$(<:.cpp=) > $@
 	diff $@ $(<:.cpp=.output)
 	rm $(<:.cpp=) $@
@@ -28,6 +28,10 @@ create_output: $(EXAMPLES:.cpp=.output)
 # check output of all stand-alone example files
 check_output: $(EXAMPLES:.cpp=.test)
 
+# check output of all stand-alone example files (exclude files with platform-dependent output.)
+# This target is used in the CI (ci_test_documentation).
+check_output_portable: $(filter-out examples/meta.test examples/max_size.test examples/std_hash.test examples/basic_json__CompatibleType.test,$(EXAMPLES:.cpp=.test))
+
 clean:
 	rm -fr $(EXAMPLES:.cpp=)
 	$(MAKE) clean -C docset
diff --git a/docs/examples/json_pointer__back.cpp b/docs/examples/json_pointer__back.cpp
index 3d57c589a..dd3b210bf 100644
--- a/docs/examples/json_pointer__back.cpp
+++ b/docs/examples/json_pointer__back.cpp
@@ -10,6 +10,6 @@ int main()
     json::json_pointer ptr2("/foo/0");
 
     // call empty()
-    std::cout << "last reference token of " << ptr1 << " is " << ptr1.back() << '\n'
-              << "last reference token of " << ptr2 << " is " << ptr2.back() << std::endl;
+    std::cout << "last reference token of \"" << ptr1 << "\" is \"" << ptr1.back() << "\"\n"
+              << "last reference token of \"" << ptr2 << "\" is \"" << ptr2.back() << "\"" << std::endl;
 }
diff --git a/docs/examples/json_pointer__back.output b/docs/examples/json_pointer__back.output
index da4d02794..a89357b49 100644
--- a/docs/examples/json_pointer__back.output
+++ b/docs/examples/json_pointer__back.output
@@ -1,2 +1,2 @@
-last reference token of "/foo" is foo
-last reference token of "/foo/0" is 0
+last reference token of "/foo" is "foo"
+last reference token of "/foo/0" is "0"
diff --git a/docs/examples/json_pointer__empty.cpp b/docs/examples/json_pointer__empty.cpp
index 5daaadc6c..57257e8b1 100644
--- a/docs/examples/json_pointer__empty.cpp
+++ b/docs/examples/json_pointer__empty.cpp
@@ -13,8 +13,8 @@ int main()
 
     // call empty()
     std::cout << std::boolalpha
-              << ptr0 << ": " << ptr0.empty() << '\n'
-              << ptr1 << ": " << ptr1.empty() << '\n'
-              << ptr2 << ": " << ptr2.empty() << '\n'
-              << ptr3 << ": " << ptr3.empty() << std::endl;
+              << "\"" << ptr0 << "\": " << ptr0.empty() << '\n'
+              << "\"" << ptr1 << "\": " << ptr1.empty() << '\n'
+              << "\"" << ptr2 << "\": " << ptr2.empty() << '\n'
+              << "\"" << ptr3 << "\": " << ptr3.empty() << std::endl;
 }
diff --git a/docs/examples/json_pointer__operator_add.cpp b/docs/examples/json_pointer__operator_add.cpp
index a2bbf59e8..14bd74561 100644
--- a/docs/examples/json_pointer__operator_add.cpp
+++ b/docs/examples/json_pointer__operator_add.cpp
@@ -7,17 +7,17 @@ int main()
 {
     // create a JSON pointer
     json::json_pointer ptr("/foo");
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 
     // append a JSON Pointer
     ptr /= json::json_pointer("/bar/baz");
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 
     // append a string
     ptr /= "fob";
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 
     // append an array index
     ptr /= 42;
-    std::cout << ptr << std::endl;
+    std::cout << "\"" << ptr << "\"" << std::endl;
 }
diff --git a/docs/examples/json_pointer__operator_add_binary.cpp b/docs/examples/json_pointer__operator_add_binary.cpp
index 89e0a6a53..d26a0d171 100644
--- a/docs/examples/json_pointer__operator_add_binary.cpp
+++ b/docs/examples/json_pointer__operator_add_binary.cpp
@@ -9,11 +9,11 @@ int main()
     json::json_pointer ptr("/foo");
 
     // append a JSON Pointer
-    std::cout << ptr / json::json_pointer("/bar/baz") << '\n';
+    std::cout << "\"" << ptr / json::json_pointer("/bar/baz") << "\"\n";
 
     // append a string
-    std::cout << ptr / "fob" << '\n';
+    std::cout << "\"" << ptr / "fob" << "\"\n";
 
     // append an array index
-    std::cout << ptr / 42 << std::endl;
+    std::cout << "\"" << ptr / 42 << "\"" << std::endl;
 }
diff --git a/docs/examples/json_pointer__parent_pointer.cpp b/docs/examples/json_pointer__parent_pointer.cpp
index 6021463a1..ef9df4534 100644
--- a/docs/examples/json_pointer__parent_pointer.cpp
+++ b/docs/examples/json_pointer__parent_pointer.cpp
@@ -12,7 +12,7 @@ int main()
 
     // call parent_pointer()
     std::cout << std::boolalpha
-              << "parent of " << ptr1 << " is " << ptr1.parent_pointer() << '\n'
-              << "parent of " << ptr2 << " is " << ptr2.parent_pointer() << '\n'
-              << "parent of " << ptr3 << " is " << ptr3.parent_pointer() << std::endl;
+              << "parent of \"" << ptr1 << "\" is \"" << ptr1.parent_pointer() << "\"\n"
+              << "parent of \"" << ptr2 << "\" is \"" << ptr2.parent_pointer() << "\"\n"
+              << "parent of \"" << ptr3 << "\" is \"" << ptr3.parent_pointer() << "\"" << std::endl;
 }
diff --git a/docs/examples/json_pointer__pop_back.cpp b/docs/examples/json_pointer__pop_back.cpp
index ed3417ec1..fd077b7e9 100644
--- a/docs/examples/json_pointer__pop_back.cpp
+++ b/docs/examples/json_pointer__pop_back.cpp
@@ -7,15 +7,15 @@ int main()
 {
     // create empty JSON Pointer
     json::json_pointer ptr("/foo/bar/baz");
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 
     // call pop_back()
     ptr.pop_back();
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 
     ptr.pop_back();
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 
     ptr.pop_back();
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 }
diff --git a/docs/examples/json_pointer__push_back.cpp b/docs/examples/json_pointer__push_back.cpp
index d6536b3f9..e6b59a125 100644
--- a/docs/examples/json_pointer__push_back.cpp
+++ b/docs/examples/json_pointer__push_back.cpp
@@ -7,15 +7,15 @@ int main()
 {
     // create empty JSON Pointer
     json::json_pointer ptr;
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 
     // call push_back()
     ptr.push_back("foo");
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 
     ptr.push_back("0");
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 
     ptr.push_back("bar");
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 }
diff --git a/docs/examples/json_pointer__to_string.cpp b/docs/examples/json_pointer__to_string.cpp
index ae1361aaa..31d35a724 100644
--- a/docs/examples/json_pointer__to_string.cpp
+++ b/docs/examples/json_pointer__to_string.cpp
@@ -19,16 +19,16 @@ int main()
     json::json_pointer ptr11("/ ");
     json::json_pointer ptr12("/m~0n");
 
-    std::cout << ptr1.to_string() << '\n'
-              << ptr2.to_string() << '\n'
-              << ptr3.to_string() << '\n'
-              << ptr4.to_string() << '\n'
-              << ptr5.to_string() << '\n'
-              << ptr6.to_string() << '\n'
-              << ptr7.to_string() << '\n'
-              << ptr8.to_string() << '\n'
-              << ptr9.to_string() << '\n'
-              << ptr10.to_string() << '\n'
-              << ptr11.to_string() << '\n'
-              << ptr12.to_string() << std::endl;
+    std::cout << "\"" << ptr1.to_string() << "\"\n"
+              << "\"" << ptr2.to_string() << "\"\n"
+              << "\"" << ptr3.to_string() << "\"\n"
+              << "\"" << ptr4.to_string() << "\"\n"
+              << "\"" << ptr5.to_string() << "\"\n"
+              << "\"" << ptr6.to_string() << "\"\n"
+              << "\"" << ptr7.to_string() << "\"\n"
+              << "\"" << ptr8.to_string() << "\"\n"
+              << "\"" << ptr9.to_string() << "\"\n"
+              << "\"" << ptr10.to_string() << "\"\n"
+              << "\"" << ptr11.to_string() << "\"\n"
+              << "\"" << ptr12.to_string() << "\"" << std::endl;
 }
diff --git a/docs/examples/json_pointer__to_string.output b/docs/examples/json_pointer__to_string.output
index c4b5ea8fa..3c441357e 100644
--- a/docs/examples/json_pointer__to_string.output
+++ b/docs/examples/json_pointer__to_string.output
@@ -1,12 +1,12 @@
-
-/foo
-/foo/0
-/
-/a~1b
-/c%d
-/e^f
-/g|h
-/i\j
-/k"l
-/ 
-/m~0n
+""
+"/foo"
+"/foo/0"
+"/"
+"/a~1b"
+"/c%d"
+"/e^f"
+"/g|h"
+"/i\j"
+"/k"l"
+"/ "
+"/m~0n"
diff --git a/docs/examples/patch_inplace.cpp b/docs/examples/patch_inplace.cpp
index 62bc527d8..2224b7061 100644
--- a/docs/examples/patch_inplace.cpp
+++ b/docs/examples/patch_inplace.cpp
@@ -30,5 +30,5 @@ int main()
     doc.patch_inplace(patch);
 
     // output patched document
-    std::cout << "After\n" << std::setw(4) << doc << std::endl;
+    std::cout << "\nAfter\n" << std::setw(4) << doc << std::endl;
 }
diff --git a/docs/mkdocs/docs/api/basic_json/basic_json.md b/docs/mkdocs/docs/api/basic_json/basic_json.md
index 365cd7c22..e2e73612c 100644
--- a/docs/mkdocs/docs/api/basic_json/basic_json.md
+++ b/docs/mkdocs/docs/api/basic_json/basic_json.md
@@ -317,6 +317,8 @@ basic_json(basic_json&& other) noexcept;
     --8<-- "examples/basic_json__CompatibleType.output"
     ```
 
+    Note the output is platform-dependent.
+
 ??? example "Example: (5) create a container (array or object) from an initializer list"
 
     The example below shows how JSON values are created from initializer lists.
diff --git a/docs/mkdocs/docs/api/basic_json/max_size.md b/docs/mkdocs/docs/api/basic_json/max_size.md
index 31339dbe9..4c0c57520 100644
--- a/docs/mkdocs/docs/api/basic_json/max_size.md
+++ b/docs/mkdocs/docs/api/basic_json/max_size.md
@@ -40,7 +40,7 @@ string elements the JSON value can store which is `1`.
 
 ??? example
 
-    The following code calls `max_size()` on the different value types. Note the output is implementation specific.
+    The following code calls `max_size()` on the different value types.
         
     ```cpp
     --8<-- "examples/max_size.cpp"
@@ -52,6 +52,8 @@ string elements the JSON value can store which is `1`.
     --8<-- "examples/max_size.output"
     ```
 
+    Note the output is platform-dependent.
+
 ## Version history
 
 - Added in version 1.0.0.
diff --git a/docs/mkdocs/docs/api/basic_json/meta.md b/docs/mkdocs/docs/api/basic_json/meta.md
index 87767e4d5..34d35ba8e 100644
--- a/docs/mkdocs/docs/api/basic_json/meta.md
+++ b/docs/mkdocs/docs/api/basic_json/meta.md
@@ -32,8 +32,7 @@ Constant.
 
 ??? example
 
-    The following code shows an example output of the `meta()`
-    function.
+    The following code shows an example output of the `meta()` function.
     
     ```cpp
     --8<-- "examples/meta.cpp"
@@ -45,6 +44,8 @@ Constant.
     --8<-- "examples/meta.output"
     ```
 
+    Note the output is platform-dependent.
+
 ## See also
 
 - [**NLOHMANN_JSON_VERSION_MAJOR**/**NLOHMANN_JSON_VERSION_MINOR**/**NLOHMANN_JSON_VERSION_PATCH**](../macros/nlohmann_json_version_major.md) - library version information
diff --git a/docs/mkdocs/docs/api/basic_json/std_hash.md b/docs/mkdocs/docs/api/basic_json/std_hash.md
index b66515d5a..b9de74f8c 100644
--- a/docs/mkdocs/docs/api/basic_json/std_hash.md
+++ b/docs/mkdocs/docs/api/basic_json/std_hash.md
@@ -26,6 +26,8 @@ type of the JSON value is taken into account to have different hash values for `
     --8<-- "examples/std_hash.output"
     ```
 
+    Note the output is platform-dependent.
+
 ## Version history
 
 - Added in version 1.0.0.