diff --git a/doc/docs.md b/doc/docs.md
index fca55ee7ed7cb0..0091d9f5bf3564 100644
--- a/doc/docs.md
+++ b/doc/docs.md
@@ -258,7 +258,7 @@ This means that a "hello world" program in V is as simple as
 println('hello world')
 ```
 
-> **Note**
+> [!NOTE]
 > If you do not explicitly use `fn main() {}`, you need to make sure that all your
 > declarations come before any variable assignment statements or top level function calls,
 > since V will consider everything after the first assignment/function call as part of your
@@ -292,12 +292,12 @@ import os
 println(os.args)
 ```
 
-> **Note**
+> [!NOTE]
 > After a successful run, V will delete the generated executable.
 > If you want to keep it, use `v -keepc run .` instead, or just compile
 > manually with `v .` .
 
-> **Note**
+> [!NOTE]
 > Any V compiler flags should be passed *before* the `run` command.
 > Everything after the source file/folder, will be passed to the program
 > as is - it will not be processed by V.
@@ -368,7 +368,7 @@ Functions are private (not exported) by default.
 To allow other [modules](#module-imports) to use them, prepend `pub`. The same applies
 to [structs](#structs), [constants](#constants) and [types](#type-declarations).
 
-> **Note**
+> [!NOTE]
 > `pub` can only be used from a named module.
 > For information about creating a module, see [Modules](#modules).
 
@@ -487,7 +487,7 @@ voidptr // this one is mostly used for [C interoperability](#v-and-c)
 any // similar to C's void* and Go's interface{}
 ```
 
-> **Note**
+> [!NOTE]
 > Unlike C and Go, `int` is always a 32 bit integer.
 
 There is an exception to the rule that all operators
@@ -540,7 +540,9 @@ windows_newline := '\r\n'      // escape special characters like in C
 assert windows_newline.len == 2
 
 // arbitrary bytes can be directly specified using `\x##` notation where `#` is
-// a hex digit aardvark_str := '\x61ardvark' assert aardvark_str == 'aardvark'
+// a hex digit
+aardvark_str := '\x61ardvark'
+assert aardvark_str == 'aardvark'
 assert '\xc0'[0] == u8(0xc0)
 
 // or using octal escape `\###` notation where `#` is an octal digit
@@ -636,6 +638,7 @@ To use a format specifier, follow this pattern:
 - flags: may be zero or more of the following: `-` to left-align output within the field, `0` to use
   `0` as the padding character instead of the default `space` character.
   > **Note**
+  >
   > V does not currently support the use of `'` or `#` as format flags, and V supports but
   > doesn't need `+` to right-align since that's the default.
 - width: may be an integer value describing the minimum width of total field to output.
@@ -650,11 +653,13 @@ To use a format specifier, follow this pattern:
   digits, `s` requires a string (almost never used).
 
   > **Note**
+  >
   > When a numeric type can render alphabetic characters, such as hex strings or special values
   > like `infinity`, the lowercase version of the type forces lowercase alphabetics and the
   > uppercase version forces uppercase alphabetics.
 
   > **Note**
+  >
   > In most cases, it's best to leave the format type empty. Floats will be rendered by
   > default as `g`, integers will be rendered by default as `d`, and `s` is almost always redundant.
   > There are only three cases where specifying a type is recommended:
@@ -901,7 +906,7 @@ println(nums.len) // "0"
 `data` is a field (of type `voidptr`) with the address of the first
 element. This is for low-level [`unsafe`](#memory-unsafe-code) code.
 
-> **Note**
+> [!NOTE]
 > Fields are read-only and can't be modified by the user.
 
 #### Array Initialization
@@ -948,7 +953,7 @@ for i in 0 .. 1000 {
 }
 ```
 
-> **Note**
+> [!NOTE]
 > The above code uses a [range `for`](#range-for) statement.
 
 You can initialize the array by accessing the `index` variable which gives
@@ -1457,7 +1462,7 @@ fn main() {
 }
 ```
 
-> **Note**
+> [!NOTE]
 > This will import the module as well. Also, this is not allowed for
 > constants - they must always be prefixed.
 
@@ -1476,7 +1481,7 @@ println('Your OS is ${current_os}.')
 
 Any imported module name can be aliased using the `as` keyword:
 
-> **Note**
+> [!NOTE]
 > This example will not compile unless you have created `mymod/sha256/somename.v`
 > (submodule names are determined by their path, not by the names of the .v file(s) in them).
 
@@ -1799,7 +1804,7 @@ println(num)
 
 Constants can also be used in the range branch expressions.
 
-> **Note**
+> [!NOTE]
 > `match` as an expression is not usable in `for` loop and `if` statements.
 
 ### In operator
@@ -1813,7 +1818,7 @@ println(1 in nums) // true
 println(4 !in nums) // true
 ```
 
-> **Note**
+> [!NOTE]
 > `in` checks if map contains a key, not a value.
 
 ```v
@@ -2455,7 +2460,7 @@ user := User.new()
 This is an alternative to factory functions like `fn new_user() User {}` and should be used
 instead.
 
-> **Note**
+> [!NOTE]
 > Note, that these are not constructors, but simple functions. V doesn't have constructors or
 > classes.
 
@@ -2654,7 +2659,7 @@ Output: `Size: 4B, clr1.b: 136, clr2.b: 0`
 
 Union member access must be performed in an `unsafe` block.
 
-> **Note**
+> [!NOTE]
 > Embedded struct arguments are not necessarily stored in the order listed.
 
 ## Functions 2
@@ -2670,7 +2675,7 @@ are a function of their arguments only, and their evaluation has no side effects
 
 Function arguments are immutable by default, even when [references](#references) are passed.
 
-> **Note**
+> [!NOTE]
 > However, V is not a purely functional language.
 
 There is a compiler flag to enable global variables (`-enable-globals`), but this is
@@ -3034,7 +3039,7 @@ fn panic(s string) // prints a message and backtraces on stderr, and terminates
 fn print_backtrace() // prints backtraces on stderr
 ```
 
-> **Note**
+> [!NOTE]
 > Although the `print` functions take a string, V accepts other printable types too.
 > See below for details.
 
@@ -3468,7 +3473,7 @@ fn fn1(s Foo) {
 #### Casting an interface
 
 We can test the underlying type of an interface using dynamic cast operators.
-> **Note**
+> [!NOTE]
 > Dynamic cast converts variable `s` into a pointer inside the `if` statemnts in this example:
 
 ```v oksyntax
@@ -3543,7 +3548,7 @@ They are just a convenient way to write `i.some_function()` instead of
 `some_function(i)`, similar to how struct methods can be looked at, as
 a convenience for writing `s.xyz()` instead of `xyz(s)`.
 
-> **Note**
+> [!NOTE]
 > This feature is NOT a "default implementation" like in C#.
 
 For example, if a struct `cat` is wrapped in an interface `a`, that has
@@ -3892,7 +3897,7 @@ Here, you can either call `panic()` or `exit()`, which will stop the execution o
 entire program, or use a control flow statement (`return`, `break`, `continue`, etc)
 to break from the current block.
 
-> **Note**
+> [!NOTE]
 > `break` and `continue` can only be used inside a `for` loop.
 
 V does not have a way to forcibly "unwrap" an option (as other languages do,
@@ -4061,7 +4066,7 @@ fn main() {
 }
 ```
 
-> **Note**
+> [!NOTE]
 > Threads rely on the machine's CPU (number of cores/threads).
 > Be aware that OS threads spawned with `spawn`
 > have limitations in regard to concurrency, 
@@ -4463,7 +4468,7 @@ assert fails it is reported to *stderr*, and the values on each side of a compar
 unexpected value. Assert statements can be used in any function, not just test ones,
 which is handy when developing new functionality, to keep your invariants in check.
 
-> **Note**
+> [!NOTE]
 > All `assert` statements are *removed*, when you compile your program with the `-prod` flag.
 
 ### Asserts with an extra message
@@ -4512,7 +4517,7 @@ assert_continues_example.v:3: FAIL: fn main.abc: assert ii == 2
   right value: 2
 ```
 
-> **Note**
+> [!NOTE]
 > V also supports a command line flag `-assert continues`, which will change the
 > behaviour of all asserts globally, as if you had tagged every function with `[assert_continues]`.
 
@@ -4543,7 +4548,7 @@ fn test_hello() {
 To run the test file above, use `v hello_test.v`. This will check that the function `hello` is
 producing the correct output. V executes all test functions in the file.
 
-> **Note**
+> [!NOTE]
 > All `_test.v` files (both external and internal ones), are compiled as *separate programs*.
 > In other words, you may have as many `_test.v` files, and tests in them as you like, they will
 > not affect the compilation of your other code in `.v` files normally at all, but only when you
@@ -4598,7 +4603,7 @@ put .v files with invalid V source code, or other tests, including known
 failing ones, that should be run in a specific way/options by a parent _test.v
 file.
 
-> **Note**
+> [!NOTE]
 > The path to the V compiler, is available through @VEXE, so a _test.v
 > file, can easily run *other* test files like this:
 
@@ -4655,7 +4660,7 @@ For developers willing to have more low level control, autofree can be disabled
 `-manualfree`, or by adding a `[manualfree]` on each function that wants manage its
 memory manually. (See [attributes](#attributes)).
 
-> **Note**
+> [!NOTE]
 > Autofree is still WIP. Until it stabilises and becomes the default, please
 > avoid using it. Right now allocations are handled by a minimal and well performing GC
 > until V's autofree engine is production ready.
@@ -5559,7 +5564,7 @@ A program that prints its own source code (a quine):
 print($embed_file(@FILE).to_string())
 ```
 
-> **Note**
+> [!NOTE]
 > you can have arbitrary source code in the file, without problems, since the full file
 > will be embeded into the executable, produced by compiling it. Also note that printing
 > is done with `print` and not `println`, to not add another new line, missing in the
@@ -5867,7 +5872,8 @@ With the example above:
   single block. `customflag` should be a snake_case identifier, it can not
   contain arbitrary characters (only lower case latin letters + numbers + `_`).
   > **Note**
-> A combinatorial `_d_customflag_linux.c.v` postfix will not work.
+  >
+  > A combinatorial `_d_customflag_linux.c.v` postfix will not work.
   > If you do need a custom flag file, that has platform dependent code, use the
   > postfix `_d_customflag.v`, and then use platform dependent compile time
   > conditional blocks inside it, i.e. `$if linux {}` etc.
@@ -5920,7 +5926,7 @@ If you suspect your program does violate memory-safety, you have a head start on
 finding the cause: look at the `unsafe` blocks (and how they interact with
 surrounding code).
 
-> **Note**
+> [!NOTE]
 > This is work in progress.
 
 ## Structs with reference fields
@@ -6409,7 +6415,7 @@ or
 v -os linux .
 ```
 
-> **Note**
+> [!NOTE]
 > Cross-compiling a windows binary on a linux machine requires the GNU C compiler for
 > MinGW-w64 (targeting Win64) to first be installed.
 
@@ -6593,7 +6599,7 @@ Add `#flag` directives to the top of your V files to provide C compilation flags
 You can (optionally) use different flags for different targets.
 Currently the `linux`, `darwin` , `freebsd`, and `windows` flags are supported.
 
-> **Note**
+> [!NOTE]
 > Each flag must go on its own line (for now)
 
 ```v oksyntax
@@ -6672,7 +6678,7 @@ Module {
 #include "header.h"
 ```
 
-> **Note**
+> [!NOTE]
 > @VMODROOT will be replaced by V with the *nearest parent folder,
 > where there is a v.mod file*.
 > Any .v file beside or below the folder where the v.mod file is,
@@ -6698,7 +6704,7 @@ Ordinary zero terminated C strings can be converted to V strings with
 `unsafe { &char(cstring).vstring() }` or if you know their length already with
 `unsafe { &char(cstring).vstring_with_len(len) }`.
 
-> **Note**
+> [!NOTE]
 > The `.vstring()` and `.vstring_with_len()` methods do NOT create a copy of the `cstring`,
 > so you should NOT free it after calling the method `.vstring()`.
 > If you need to make a copy of the C string (some libc APIs like `getenv` pretty much require that,
@@ -7112,4 +7118,4 @@ Assignment Operators
 +=   -=   *=   /=   %=
 &=   |=   ^=
 >>=  <<=  >>>=
-```
\ No newline at end of file
+```