diff --git a/src/__tests__/deprecated.spec.ts b/src/__tests__/deprecated.spec.ts
index 493b8c7f80..913a6c7abf 100644
--- a/src/__tests__/deprecated.spec.ts
+++ b/src/__tests__/deprecated.spec.ts
@@ -149,7 +149,7 @@ describe('deprecated APIs', () => {
      * const $ = cheerio.load('<h1>Hello, <span>world</span>.</h1>');
      *
      * $('h1').html();
-     * //=> '<h1>Hello, <span>world</span>.'
+     * //=> 'Hello, <span>world</span>.'
      * ```
      *
      * @example <caption>To render the markup of an entire document, invoke the
diff --git a/src/api/attributes.ts b/src/api/attributes.ts
index 47d0406fae..23781ee854 100644
--- a/src/api/attributes.ts
+++ b/src/api/attributes.ts
@@ -146,7 +146,7 @@ export function attr<T extends AnyNode>(
  * @example
  *
  * ```js
- * $('.apple').attr('id', 'favorite').html();
+ * $('.apple').attr('id', 'favorite').prop('outerHTML');
  * //=> <li class="apple" id="favorite">Apple</li>
  * ```
  *
@@ -172,7 +172,7 @@ export function attr<T extends AnyNode>(
  * @example
  *
  * ```js
- * $('.apple').attr({ id: 'favorite' }).html();
+ * $('.apple').attr({ id: 'favorite' }).prop('outerHTML');
  * //=> <li class="apple" id="favorite">Apple</li>
  * ```
  *
@@ -760,7 +760,7 @@ export function val<T extends AnyNode>(
  * @example
  *
  * ```js
- * $('input[type="text"]').val('test').html();
+ * $('input[type="text"]').val('test').prop('outerHTML');
  * //=> <input type="text" value="test"/>
  * ```
  *
@@ -848,11 +848,11 @@ function splitNames(names?: string): string[] {
  * @example
  *
  * ```js
- * $('.pear').removeAttr('class').html();
+ * $('.pear').removeAttr('class').prop('outerHTML');
  * //=> <li>Pear</li>
  *
  * $('.apple').attr('id', 'favorite');
- * $('.apple').removeAttr('id class').html();
+ * $('.apple').removeAttr('id class').prop('outerHTML');
  * //=> <li>Apple</li>
  * ```
  *
@@ -928,10 +928,10 @@ export function hasClass<T extends AnyNode>(
  * @example
  *
  * ```js
- * $('.pear').addClass('fruit').html();
+ * $('.pear').addClass('fruit').prop('outerHTML');
  * //=> <li class="pear fruit">Pear</li>
  *
- * $('.apple').addClass('fruit red').html();
+ * $('.apple').addClass('fruit red').prop('outerHTML');
  * //=> <li class="apple fruit red">Apple</li>
  * ```
  *
@@ -996,10 +996,10 @@ export function addClass<T extends AnyNode, R extends ArrayLike<T>>(
  * @example
  *
  * ```js
- * $('.pear').removeClass('pear').html();
+ * $('.pear').removeClass('pear').prop('outerHTML');
  * //=> <li class="">Pear</li>
  *
- * $('.apple').addClass('red').removeClass().html();
+ * $('.apple').addClass('red').removeClass().prop('outerHTML');
  * //=> <li class="">Apple</li>
  * ```
  *
@@ -1066,10 +1066,10 @@ export function removeClass<T extends AnyNode, R extends ArrayLike<T>>(
  * @example
  *
  * ```js
- * $('.apple.green').toggleClass('fruit green red').html();
+ * $('.apple.green').toggleClass('fruit green red').prop('outerHTML');
  * //=> <li class="apple fruit red">Apple</li>
  *
- * $('.apple.green').toggleClass('fruit green red', true).html();
+ * $('.apple.green').toggleClass('fruit green red', true).prop('outerHTML');
  * //=> <li class="apple green fruit red">Apple</li>
  * ```
  *