chores: convert noteblocks

files/zh-tw/web/api/keyboardevent/index.md

@@ -35,15 +35,18 @@ _本介面（ interface）亦繼承其父，{{domxref("UIEvent")}} 和 {{domxref
 
   - : 一個 {{domxref("DOMString")}} ，返回鍵盤對應的字符。若是該鍵對應一個實際的字符，則其值為對應該字符的一個非空的 Unicode 字串；若沒對應的話，則返回一個空字串。
 
-    > **備註：** If the key is used as a macro that inserts multiple characters, this attribute's value is the entire string, not just the first character.
+    > [!NOTE]
+    > If the key is used as a macro that inserts multiple characters, this attribute's value is the entire string, not just the first character.
 
-    > **警告：** 在 DOM Level 3 Events ，該 propertie 已被移除。現在只有 IE9+ 支持它。
+    > [!WARNING]
+    > 在 DOM Level 3 Events ，該 propertie 已被移除。現在只有 IE9+ 支持它。
 
 - {{domxref("KeyboardEvent.charCode")}} {{Deprecated_inline}}{{Readonlyinline}}
 
   - : Returns a {{jsxref("Number")}} representing the Unicode reference number of the key; this attribute is used only by the `keypress` event. For keys whose `char` attribute contains multiple characters, this is the Unicode value of the first character in that attribute. In Firefox 26 this returns codes for printable characters.
 
-    > **警告：** 此 attribute 已被淘汰。如果可以，建議使用 {{domxref("KeyboardEvent.key")}}。
+    > [!WARNING]
+    > 此 attribute 已被淘汰。如果可以，建議使用 {{domxref("KeyboardEvent.key")}}。
 
 - {{domxref("KeyboardEvent.code")}} {{Readonlyinline}}
   - : 一個 {{domxref("DOMString")}} 。返回事件對應的按鍵的代碼。
@@ -57,13 +60,15 @@ _本介面（ interface）亦繼承其父，{{domxref("UIEvent")}} 和 {{domxref
 
   - : Returns a {{jsxref("Number")}} representing a system and implementation dependent numerical code identifying the unmodified value of the pressed key.
 
-    > **警告：** 此 attribute 已被淘汰。如果可以，建議使用{{domxref("KeyboardEvent.key")}}。
+    > [!WARNING]
+    > 此 attribute 已被淘汰。如果可以，建議使用{{domxref("KeyboardEvent.key")}}。
 
 - {{domxref("KeyboardEvent.locale")}} {{Readonlyinline}}
 
   - : Returns a {{domxref("DOMString")}} representing a locale string indicating the locale the keyboard is configured for. This may be the empty string if the browser or device doesn't know the keyboard's locale.
 
-    > **備註：** This does not describe the locale of the data being entered. A user may be using one keyboard layout while typing text in a different language.
+    > [!NOTE]
+    > This does not describe the locale of the data being entered. A user may be using one keyboard layout while typing text in a different language.
 
 - {{domxref("KeyboardEvent.location")}} {{Readonlyinline}}
   - : Returns a {{jsxref("Number")}} representing the location of the key on the keyboard or other input device.
@@ -77,7 +82,8 @@ _本介面（ interface）亦繼承其父，{{domxref("UIEvent")}} 和 {{domxref
 
   - : Returns a {{jsxref("Number")}} representing a system and implementation dependent numeric code identifying the unmodified value of the pressed key; this is usually the same as `keyCode`.
 
-    > **警告：** 此 attribute 已被淘汰。如果可以，建議使用 {{domxref("KeyboardEvent.key")}}。
+    > [!WARNING]
+    > 此 attribute 已被淘汰。如果可以，建議使用 {{domxref("KeyboardEvent.key")}}。
 
 ## 注意
 

files/zh-tw/web/api/nodelist/index.md

@@ -7,7 +7,8 @@ slug: Web/API/NodeList
 
 **`NodeList`** 物件是節點的集合，可藉由 {{domxref("Node.childNodes")}} 屬性以及 {{domxref("document.querySelectorAll()")}} 方法取得。
 
-> **備註：** 雖然 `NodeList` 不是 `Array`，但仍可以使用 `forEach()` 方法來進行迭代。一些老舊瀏覽器並未實作此方法。
+> [!NOTE]
+> 雖然 `NodeList` 不是 `Array`，但仍可以使用 `forEach()` 方法來進行迭代。一些老舊瀏覽器並未實作此方法。
 
 在某些情況下，`NodeList` 為*動態集合（live collection）*，意思是 DOM 的改變會反映於集合。例如，{{domxref("Node.childNodes")}} 便是即時更新（live）的：
 

files/zh-tw/web/http/status/301/index.md

@@ -9,7 +9,8 @@ l10n:
 
 HTTP **`301 Moved Permanently`** 重新導向回應碼表示所請求的資源已被永久地移動到由 {{HTTPHeader("Location")}} 標頭給出的 URL。瀏覽器將重新導向到新的 URL，並且搜索引擎會更新對該資源的連結。
 
-> **備註：** 雖然[規範](#規範)要求在執行重新導向時方法和主體保持不變，但並非所有使用者代理都符合此要求。僅將 `301` 狀態碼用作 {{HTTPMethod("GET")}} 或 {{HTTPMethod("HEAD")}} 方法的回應，對於 {{HTTPMethod("POST")}} 方法，請改用 {{HTTPStatus("308", "308 Permanent Redirect")}}，因為此狀態明確禁止更改方法。
+> [!NOTE]
+> 雖然[規範](#規範)要求在執行重新導向時方法和主體保持不變，但並非所有使用者代理都符合此要求。僅將 `301` 狀態碼用作 {{HTTPMethod("GET")}} 或 {{HTTPMethod("HEAD")}} 方法的回應，對於 {{HTTPMethod("POST")}} 方法，請改用 {{HTTPStatus("308", "308 Permanent Redirect")}}，因為此狀態明確禁止更改方法。
 
 ## 狀態
 

files/zh-tw/web/http/status/304/index.md

@@ -11,7 +11,8 @@ HTTP **`304 Not Modified`** 重新導向回應碼表示無需重新傳送所請
 
 回應不得包含主體，並且必須包括與等效的 {{HTTPStatus("200")}} `OK` 回應中會發送的標頭：{{HTTPHeader("Cache-Control")}}、{{HTTPHeader("Content-Location")}}、{{HTTPHeader("Date")}}、{{HTTPHeader("ETag")}}、{{HTTPHeader("Expires")}} 和 {{HTTPHeader("Vary")}}。
 
-> **備註：** 許多[開發者工具的「網路」面板](https://firefox-source-docs.mozilla.org/devtools-user/network_monitor/index.html)會創建多餘的請求，導致出現 `304` 回應，這樣開發人員就可以查看對本地緩存的訪問。
+> [!NOTE]
+> 許多[開發者工具的「網路」面板](https://firefox-source-docs.mozilla.org/devtools-user/network_monitor/index.html)會創建多餘的請求，導致出現 `304` 回應，這樣開發人員就可以查看對本地緩存的訪問。
 
 ## 狀態
 

files/zh-tw/web/http/status/308/index.md

@@ -11,7 +11,8 @@ HTTP **`308 Permanent Redirect`** 永久重新導向狀態碼表示所請求的
 
 請求方法和主體不會被更改，而 {{HTTPStatus("301")}} 有時可能會錯誤地被更改為 {{HTTPMethod("GET")}} 方法。
 
-> **備註：** 一些 Web 應用可能會以非標準方式使用 `308 Permanent Redirect`，並用於其他目的。例如 Google Drive 使用 `308 Resume Incomplete` 回應來指示用戶端不完整的上傳停滯。（請參見 Google Drive 文件上的[執行可恢復的下載](https://developers.google.com/drive/api/guides/manage-uploads?hl=zh-tw)）
+> [!NOTE]
+> 一些 Web 應用可能會以非標準方式使用 `308 Permanent Redirect`，並用於其他目的。例如 Google Drive 使用 `308 Resume Incomplete` 回應來指示用戶端不完整的上傳停滯。（請參見 Google Drive 文件上的[執行可恢復的下載](https://developers.google.com/drive/api/guides/manage-uploads?hl=zh-tw)）
 
 ## 狀態
 

files/zh-tw/web/http/status/400/index.md

@@ -9,7 +9,8 @@ l10n:
 
 超文本傳輸協定（HTTP）**`400 Bad Request`** 回應狀態碼表示由於用戶端的錯誤（例如請求語法的格式錯誤、請求訊息框架無效或欺騙性的請求路由），伺服器無法或不會處理請求。
 
-> **警告：** 用戶端不應原封不動的重複此要求。
+> [!WARNING]
+> 用戶端不應原封不動的重複此要求。
 
 ## 狀態
 

files/zh-tw/web/http/status/404/index.md

@@ -27,7 +27,8 @@ ErrorDocument 404 /notfound.html
 
 有關自訂 404 頁面的範例，請參見此 [404 頁面](https://konmari.com/404)。
 
-> **備註：** 適度地自訂設計是一個好事情。可以使你的 404 頁面幽默和人性化，但不要讓你的用戶感到困惑。
+> [!NOTE]
+> 適度地自訂設計是一個好事情。可以使你的 404 頁面幽默和人性化，但不要讓你的用戶感到困惑。
 
 ## 規範
 

files/zh-tw/web/http/status/408/index.md

@@ -13,7 +13,8 @@ HTTP **`408 Request Timeout`** 回應狀態碼表示伺服器希望關閉這個
 
 自從一些瀏覽器（如 Chrome、Firefox 27+ 和 IE9）使用 HTTP 預連接機制來加速瀏覽以來，這個回應被更多地使用。
 
-> **備註：** 一些伺服器僅關閉連接而不發送此訊息。
+> [!NOTE]
+> 一些伺服器僅關閉連接而不發送此訊息。
 
 ## 狀態
 

files/zh-tw/web/http/status/410/index.md

@@ -11,7 +11,8 @@ HTTP **`410 Gone`** 用戶端錯誤回應碼表示在原始伺服器上已不再
 
 如果你不知道這種情況是暫時的還是永久的，則應改用 {{HTTPStatus(404)}} 狀態碼。
 
-> **備註：** 預設情況下，410 回應是可緩存的。
+> [!NOTE]
+> 預設情況下，410 回應是可緩存的。
 
 ## 狀態
 

files/zh-tw/web/http/status/411/index.md

@@ -9,7 +9,8 @@ l10n:
 
 HTTP **`411 Length Required`** 用戶端錯誤回應碼表示伺服器拒絕接受沒有定義 {{HTTPHeader("Content-Length")}} 標頭的請求。
 
-> **備註：** 根據規範，在以一系列塊發送數據時，會省略 `Content-Length` 標頭，而在每個塊的開頭需要以十六進制格式添加當前塊的長度。詳情請參見 {{HTTPHeader("Transfer-Encoding")}}。
+> [!NOTE]
+> 根據規範，在以一系列塊發送數據時，會省略 `Content-Length` 標頭，而在每個塊的開頭需要以十六進制格式添加當前塊的長度。詳情請參見 {{HTTPHeader("Transfer-Encoding")}}。
 
 ## 狀態
 

files/zh-tw/web/http/status/422/index.md

@@ -9,7 +9,8 @@ l10n:
 
 超文本傳輸協定（HTTP）**`422 Unprocessable Content`** 回應狀態碼表示伺服器理解請求實體的內容類型，並且請求實體的語法是正確的，但無法處理其中包含的指示。
 
-> **警告：** 用戶端不應該在未修改的情況下重複此請求。
+> [!WARNING]
+> 用戶端不應該在未修改的情況下重複此請求。
 
 ## 狀態
 

files/zh-tw/web/http/status/503/index.md

@@ -11,7 +11,8 @@ l10n:
 
 常見原因是伺服器正在進行維護或超載。此回應應用於臨時情況，如果可能，{{HTTPHeader("Retry-After")}} HTTP 標頭應包含恢復服務的預估時間。
 
-> **備註：** 伴隨此回應，應發送一個友好的頁面來解釋問題。
+> [!NOTE]
+> 伴隨此回應，應發送一個友好的頁面來解釋問題。
 
 與此回應一起發送的與緩存相關的標頭應該被處理，因為 503 狀態通常是一個臨時條件，通常不應該將回應緩存。
 

files/zh-tw/web/javascript/closures/index.md

@@ -172,7 +172,8 @@ console.log(counter.value()); // logs 1
 
 這三個公有函式，皆為共享同一個環境的閉包。由於 JavaScript 的語法作用域，它們都能訪問 `privateCounter` 變數與 `changeBy` 函式。
 
-> **備註：** 你應該也發現到我們定義了建立 counter 的匿名函式、而我們接著呼叫它，並給`counter` 變數指派了回傳值。我們也能在分離的變數 `makeCounter` 儲存函式並用其建立數個 counter。
+> [!NOTE]
+> 你應該也發現到我們定義了建立 counter 的匿名函式、而我們接著呼叫它，並給`counter` 變數指派了回傳值。我們也能在分離的變數 `makeCounter` 儲存函式並用其建立數個 counter。
 
 ```js
 var makeCounter = function () {
@@ -206,7 +207,8 @@ alert(counter2.value()); /* Alerts 0 */
 
 請注意 `counter1` 與 `counter2` 這兩個計數器是如何維護其獨立性的。每個閉包都以各自的閉包，在參照不同版本的 `privateCounter` 變數。每當呼叫其中一個計數器時，它會透過該變數的數值變更，改變語法作用域的環境。不過，在其中一個閉包的變數值改時，其他閉包的數值並不會受到影響。
 
-> **備註：** 使用這種方法的閉包，提供了一些與物件導向程式設計的益處，尤其是資料隱藏與封裝。
+> [!NOTE]
+> 使用這種方法的閉包，提供了一些與物件導向程式設計的益處，尤其是資料隱藏與封裝。
 
 ## 在迴圈建立閉包：一個常見錯誤
 

files/zh-tw/web/javascript/data_structures/index.md

@@ -129,7 +129,8 @@ Associates a key with one or two accessor functions (get and set) to retrieve or
 | [[Enumerable]]   | Boolean                      | If `true`, the property will be enumerated in [for...in](/zh-TW/docs/Web/JavaScript/Reference/Statements/for...in) loops.                                                                                                | false         |
 | [[Configurable]] | Boolean                      | If `false`, the property can't be deleted and can't be changed to a data property.                                                                                                                                       | false         |
 
-> **備註：** Attribute is usually used by JavaScript engine, so you can't directly access it(see more about [Object.defineProperty()](/zh-TW/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty)).That's why the attribute is put in double square brackets instead of single.
+> [!NOTE]
+> Attribute is usually used by JavaScript engine, so you can't directly access it(see more about [Object.defineProperty()](/zh-TW/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty)).That's why the attribute is put in double square brackets instead of single.
 
 ### "Normal" objects, and functions
 

files/zh-tw/web/javascript/guide/control_flow_and_error_handling/index.md

@@ -240,7 +240,8 @@ throw {
 };
 ```
 
-> **備註：** 你可以在拋出例外時指定物件。然後，可以在 catch 區塊中引用對象的屬性。
+> [!NOTE]
+> 你可以在拋出例外時指定物件。然後，可以在 catch 區塊中引用對象的屬性。
 
 ```js
 // 創建類型爲 UserException 的物件

files/zh-tw/web/javascript/guide/grammar_and_types/index.md

@@ -348,7 +348,8 @@ y = 42 + " is the answer"; // "42 is the answer"
 var coffees = ["French Roast", "Colombian", "Kona"];
 ```
 
-> **備註：** An array literal is a type of object initializer. See [Using Object Initializers](/zh-TW/docs/Web/JavaScript/Guide/Working_with_Objects#Using_object_initializers).
+> [!NOTE]
+> An array literal is a type of object initializer. See [Using Object Initializers](/zh-TW/docs/Web/JavaScript/Guide/Working_with_Objects#Using_object_initializers).
 
 If an array is created using a literal in a top-level script, JavaScript interprets the array each time it evaluates the expression containing the array literal. In addition, a literal used in a function is created each time the function is called.
 
@@ -366,7 +367,8 @@ This array has two elements with values and one empty element (`fish[0]` is "Lio
 
 If you include a trailing comma at the end of the list of elements, the comma is ignored. In the following example, the length of the array is three. There is no `myList[3]`. All other commas in the list indicate a new element.
 
-> **備註：** Trailing commas can create errors in older browser versions and it is a best practice to remove them.
+> [!NOTE]
+> Trailing commas can create errors in older browser versions and it is a best practice to remove them.
 
 ```js
 var myList = ["home", , "school"];

files/zh-tw/web/javascript/guide/introduction/index.md

@@ -125,7 +125,8 @@ ECMAScript 規格（ECMA-262）在 Netscape 和 Ecma International 的密切合
   </tbody>
 </table>
 
-> **備註：** ECMA-262 第 2 版是由已修正錯誤的第 1 版並加上些微的更動構成。現今由 Ecma International 的 TC39 工作組（TC39 Working Group）所發行的版本是 ECMAScript 5.1 版
+> [!NOTE]
+> ECMA-262 第 2 版是由已修正錯誤的第 1 版並加上些微的更動構成。現今由 Ecma International 的 TC39 工作組（TC39 Working Group）所發行的版本是 ECMAScript 5.1 版
 
 [JavaScript Reference](/zh-TW/docs/JavaScript/Reference) 指出了哪些 JavaScript 的特性是相容於 ECMAScript 的。
 

files/zh-tw/web/javascript/guide/typed_arrays/index.md

@@ -139,7 +139,8 @@ var amountDueView = new Float32Array(buffer, 20, 1);
 
 舉例來說，可以用 `amountDueView[0]` 存取 amountDue。
 
-> **備註：** C 結構的 [data structure alignment](http://en.wikipedia.org/wiki/Data_structure_alignment) 是與使用平台有關，須小心這些填充上的差異。
+> [!NOTE]
+> C 結構的 [data structure alignment](http://en.wikipedia.org/wiki/Data_structure_alignment) 是與使用平台有關，須小心這些填充上的差異。
 
 ### Conversion to normal arrays
 

files/zh-tw/web/javascript/inheritance_and_the_prototype_chain/index.md

@@ -19,7 +19,8 @@ JavaScript 是個沒有實做 `class` 關鍵字的動態語言，所以會對那
 
 JavaScript 物件是一「包」動態的屬性（也就是**它自己**的屬性）並擁有一個原型物件的鏈結，當物件試圖存取一個物件的屬性時，其不僅會尋找該物件，也會尋找該物件的原型、原型的原型……直到找到相符合的屬性，或是到達原型鏈的尾端。
 
-> **備註：** 遵照 ECMAScript 標準的 `someObject.[[Prototype]]` 標記，用於指派 `someObject` 的原型。從 ECMAScript 2015 開始， `[[Prototype]]` 使用 {{jsxref("Object.getPrototypeOf()")}} 與 {{jsxref("Object.setPrototypeOf()")}} 這兩個訪問器（accessors）訪問，等同於非標準，但各大瀏覽器已實做的 `__proto__` 屬性。
+> [!NOTE]
+> 遵照 ECMAScript 標準的 `someObject.[[Prototype]]` 標記，用於指派 `someObject` 的原型。從 ECMAScript 2015 開始， `[[Prototype]]` 使用 {{jsxref("Object.getPrototypeOf()")}} 與 {{jsxref("Object.setPrototypeOf()")}} 這兩個訪問器（accessors）訪問，等同於非標準，但各大瀏覽器已實做的 `__proto__` 屬性。
 >
 > 不要把 `someObject.[[Prototype]]` 與函式屬性 `func.prototype` 混淆了。它在函式被用作建構子的時候，指定 `[[Prototype]]` 要分派到所有由給定函式建立的物件實例（instance）。**`Object.prototype`** 屬性代表了原型屬性 {{jsxref("Object")}}。
 

files/zh-tw/web/javascript/reference/classes/index.md

@@ -178,7 +178,8 @@ class Rectangle {
 
 通過宣告這些在類別以外不可見的東西，你可以確保類別的使用者不會倚賴類別的內部結構，畢竟一個類別的內部結構可能會隨著版本的更新而有所變化。
 
-> **備註：** 私有欄位只能在建立類別時事先宣告。
+> [!NOTE]
+> 私有欄位只能在建立類別時事先宣告。
 
 私有欄位不像普通欄位一樣，可以在類別宣告完後才建立。
 

files/zh-tw/web/javascript/reference/errors/not_defined/index.md

@@ -19,7 +19,8 @@ ReferenceError: "x" is not defined
 
 有個地方參照到不存在的變數了。這個變數需要宣告、或確定在目前腳本、或在 {{Glossary("scope")}} 裡可用。
 
-> **備註：** 如果要使用函式庫（例如 jQuery）的話，請確定在你使用諸如 $ 這樣的函式庫變數前，就已載入完畢。把載入函式庫的 {{HTMLElement("script")}} 標籤，放在你使用的程式碼之前。
+> [!NOTE]
+> 如果要使用函式庫（例如 jQuery）的話，請確定在你使用諸如 $ 這樣的函式庫變數前，就已載入完畢。把載入函式庫的 {{HTMLElement("script")}} 標籤，放在你使用的程式碼之前。
 
 ## 實例
 

files/zh-tw/web/javascript/reference/global_objects/array/concat/index.md

@@ -33,7 +33,8 @@ var new_array = old_array.concat(value1[, value2[, ...[, valueN]]])
 - 物件參考（並非為實際的物件）：`concat` 複製物件的參考至新的陣列。不管是原始的還是新的陣列都參考到相同的物件。也就是說，如果一個被參照的物件被修改了，變動會同時反映到新的以及原始的陣列中。
 - 資料型態為字串、數值或是布林（非 {{jsxref("Global_Objects/String", "String")}}、{{jsxref("Global_Objects/Number", "Number")}} 及 {{jsxref("Global_Objects/Boolean", "Boolean")}} 物件）：`concat` 複製字串及數值的值到新的陣列。
 
-> **備註：** 合併（多個）陣列／（多個）值將讓原始的陣列不會被受到影響。此外，任何對新陣列（只有在元素不是物件參考的情況下）的操作都不會影響原始的陣列，反之亦然。
+> [!NOTE]
+> 合併（多個）陣列／（多個）值將讓原始的陣列不會被受到影響。此外，任何對新陣列（只有在元素不是物件參考的情況下）的操作都不會影響原始的陣列，反之亦然。
 
 ## 範例
 

files/zh-tw/web/javascript/reference/global_objects/array/indexof/index.md

@@ -7,7 +7,8 @@ slug: Web/JavaScript/Reference/Global_Objects/Array/indexOf
 
 **`indexOf()`** 方法會回傳給定元素於陣列中第一個被找到之索引，若不存在於陣列中則回傳 -1。
 
-> **備註：** 若是調用字串的方法，請參閱 {{jsxref("String.prototype.indexOf()")}}。
+> [!NOTE]
+> 若是調用字串的方法，請參閱 {{jsxref("String.prototype.indexOf()")}}。
 
 {{EmbedInteractiveExample("pages/js/array-indexof.html")}}