diff --git a/.DS_Store b/.DS_Store
index 64c2ab48e..2336d5565 100644
Binary files a/.DS_Store and b/.DS_Store differ
diff --git a/arbitrum-docs/.DS_Store b/arbitrum-docs/.DS_Store
index 1843aad2f..5bd90f510 100644
Binary files a/arbitrum-docs/.DS_Store and b/arbitrum-docs/.DS_Store differ
diff --git a/arbitrum-docs/arbitrum-bridge/01-quickstart.mdx b/arbitrum-docs/arbitrum-bridge/01-quickstart.mdx
index a40e84ab3..e27ea8c24 100644
--- a/arbitrum-docs/arbitrum-bridge/01-quickstart.mdx
+++ b/arbitrum-docs/arbitrum-bridge/01-quickstart.mdx
@@ -30,7 +30,7 @@ You'll also need to add the desired chain's RPC endpoint to your wallet. Here we
![Add the desired destination network to your MetaMask wallet](images/getting_started_users_1.png)
-Here we display the information of the most common Arbitrum chains, but you can find a more exhaustive list in our [RPC endpoints and providers](/build-decentralized-apps/reference/01-node-providers.md) page.
+Here we display the information of the most common Arbitrum chains, but you can find a more exhaustive list in our [RPC endpoints and providers](/build-decentralized-apps/reference/01-node-providers.mdx) page.
| Parameter | Arbitrum One | Arbitrum Nova | Arbitrum Sepolia (testnet) |
| ------------------ | ---------------------------- | ---------------------------- | -------------------------------------- |
diff --git a/arbitrum-docs/build-decentralized-apps/.DS_Store b/arbitrum-docs/build-decentralized-apps/.DS_Store
index 598f61e0d..f69cc878d 100644
Binary files a/arbitrum-docs/build-decentralized-apps/.DS_Store and b/arbitrum-docs/build-decentralized-apps/.DS_Store differ
diff --git a/arbitrum-docs/build-decentralized-apps/01-quickstart-solidity-hardhat.mdx b/arbitrum-docs/build-decentralized-apps/01-quickstart-solidity-hardhat.mdx
index 0ecace43c..03fa0ac1a 100644
--- a/arbitrum-docs/build-decentralized-apps/01-quickstart-solidity-hardhat.mdx
+++ b/arbitrum-docs/build-decentralized-apps/01-quickstart-solidity-hardhat.mdx
@@ -513,7 +513,7 @@ If you have any questions or feedback, reach out to us on [Discord](https://disc
- Visit [How to estimate gas](/build-decentralized-apps/02-how-to-estimate-gas.mdx) to learn how to estimate the gas cost of your smart contract transactions.
-- Visit [RPC endpoints and providers](/build-decentralized-apps/reference/01-node-providers.md#rpc-endpoints) for a list of public chains that you can deploy your smart contracts to.
+- Visit [RPC endpoints and providers](/build-decentralized-apps/reference/01-node-providers.mdx#rpc-endpoints) for a list of public chains that you can deploy your smart contracts to.
[^1]: The vending machine example was inspired by [Ethereum.org's "Introduction to Smart Contracts"](https://ethereum.org/en/developers/docs/smart-contracts/), which was inspired by [Nick Szabo's "From vending machines to smart contracts"](http://unenumerated.blogspot.com/2006/12/from-vending-machines-to-smart.html).
[^2]: Although application front-ends are usually hosted by centralized services, smart contracts allow the underlying logic and data to be partially or fully decentralized. These smart contracts are hosted and executed by Ethereum's public, decentralized network of nodes. Arbitrum has its own network of nodes that use advanced cryptography techniques to "batch process" Ethereum transactions and then submit them to Ethereum L1, which significantly reduces the cost of using Ethereum. All without requiring developers to compromise on security or decentralization.
diff --git a/arbitrum-docs/build-decentralized-apps/reference/.DS_Store b/arbitrum-docs/build-decentralized-apps/reference/.DS_Store
index 97b0824ee..aef6f53d1 100644
Binary files a/arbitrum-docs/build-decentralized-apps/reference/.DS_Store and b/arbitrum-docs/build-decentralized-apps/reference/.DS_Store differ
diff --git a/arbitrum-docs/build-decentralized-apps/reference/01-node-providers.md b/arbitrum-docs/build-decentralized-apps/reference/01-node-providers.mdx
similarity index 100%
rename from arbitrum-docs/build-decentralized-apps/reference/01-node-providers.md
rename to arbitrum-docs/build-decentralized-apps/reference/01-node-providers.mdx
diff --git a/arbitrum-docs/build-decentralized-apps/reference/04-development-frameworks.md b/arbitrum-docs/build-decentralized-apps/reference/04-development-frameworks.mdx
similarity index 100%
rename from arbitrum-docs/build-decentralized-apps/reference/04-development-frameworks.md
rename to arbitrum-docs/build-decentralized-apps/reference/04-development-frameworks.mdx
diff --git a/arbitrum-docs/build-decentralized-apps/reference/05-web3-libraries-tools.md b/arbitrum-docs/build-decentralized-apps/reference/05-web3-libraries-tools.mdx
similarity index 100%
rename from arbitrum-docs/build-decentralized-apps/reference/05-web3-libraries-tools.md
rename to arbitrum-docs/build-decentralized-apps/reference/05-web3-libraries-tools.mdx
diff --git a/arbitrum-docs/build-decentralized-apps/reference/06-monitoring-tools-block-explorers.md b/arbitrum-docs/build-decentralized-apps/reference/06-monitoring-tools-block-explorers.mdx
similarity index 100%
rename from arbitrum-docs/build-decentralized-apps/reference/06-monitoring-tools-block-explorers.md
rename to arbitrum-docs/build-decentralized-apps/reference/06-monitoring-tools-block-explorers.mdx
diff --git a/arbitrum-docs/build-decentralized-apps/reference/07-debugging-tools.md b/arbitrum-docs/build-decentralized-apps/reference/07-debugging-tools.mdx
similarity index 100%
rename from arbitrum-docs/build-decentralized-apps/reference/07-debugging-tools.md
rename to arbitrum-docs/build-decentralized-apps/reference/07-debugging-tools.mdx
diff --git a/arbitrum-docs/node-running/.DS_Store b/arbitrum-docs/node-running/.DS_Store
new file mode 100644
index 000000000..da777946f
Binary files /dev/null and b/arbitrum-docs/node-running/.DS_Store differ
diff --git a/arbitrum-docs/node-running/how-tos/running-an-orbit-node.mdx b/arbitrum-docs/node-running/how-tos/running-an-orbit-node.mdx
index 830fcd3d4..30c7c68f0 100644
--- a/arbitrum-docs/node-running/how-tos/running-an-orbit-node.mdx
+++ b/arbitrum-docs/node-running/how-tos/running-an-orbit-node.mdx
@@ -30,7 +30,7 @@ The `parent-chain` argument needs to provide a standard RPC endpoint for an EVM
:::note
-[Public Arbitrum RPC endpoints](/build-decentralized-apps/reference/01-node-providers.md#arbitrum-public-rpc-endpoints) rate-limit connections. To avoid hitting a bottleneck, you can run a local node for the parent chain or rely on third-party RPC providers.
+[Public Arbitrum RPC endpoints](/build-decentralized-apps/reference/01-node-providers.mdx#arbitrum-public-rpc-endpoints) rate-limit connections. To avoid hitting a bottleneck, you can run a local node for the parent chain or rely on third-party RPC providers.
:::
diff --git a/arbitrum-docs/partials/_contribute-docs-partial.mdx b/arbitrum-docs/partials/_contribute-docs-partial.mdx
index 396097781..393a76190 100644
--- a/arbitrum-docs/partials/_contribute-docs-partial.mdx
+++ b/arbitrum-docs/partials/_contribute-docs-partial.mdx
@@ -114,7 +114,7 @@ Every document should be a specific _type_ of document. Each type of document ha
| Concept | Explain what things are and how they work | [Token bridging](/build-decentralized-apps/token-bridging/03-token-bridge-erc20.md)
[Nodes and networks](https://docs.prylabs.network/docs/concepts/nodes-networks) |
| FAQ | Address frequently asked questions | [FAQ: Run a node](../node-running/faq.md) |
| Troubleshooting | List common troubleshooting scenarios and solutions | [Troubleshooting: Run a node](/run-arbitrum-node/06-troubleshooting.md) |
-| Reference | Lists and tables of things, such as API endpoints and developer resources | [RPC endpoints and providers](/build-decentralized-apps/reference/01-node-providers.md) |
+| Reference | Lists and tables of things, such as API endpoints and developer resources | [RPC endpoints and providers](/build-decentralized-apps/reference/01-node-providers.mdx) |
This isn't an exhaustive list, but it includes most of the document types that we use.
@@ -205,7 +205,7 @@ The following document was contributed by @todo-twitter-handle. Give them a shou
### Frequently asked questions
-#### Can I point to my product from core docs? For example - if my product hosts a public RPC endpoint, can I add it to your [RPC endpoints and providers](/build-decentralized-apps/reference/01-node-providers.md) page?
+#### Can I point to my product from core docs? For example - if my product hosts a public RPC endpoint, can I add it to your [RPC endpoints and providers](/build-decentralized-apps/reference/01-node-providers.mdx) page?
These types of contributions are generally **not merged** unless they're submitted by employees of Offchain Labs.
diff --git a/arbitrum-docs/run-arbitrum-node/.DS_Store b/arbitrum-docs/run-arbitrum-node/.DS_Store
index 73b0912a5..9735c6294 100644
Binary files a/arbitrum-docs/run-arbitrum-node/.DS_Store and b/arbitrum-docs/run-arbitrum-node/.DS_Store differ
diff --git a/arbitrum-docs/run-arbitrum-node/01-overview.md b/arbitrum-docs/run-arbitrum-node/01-overview.md
index a1252f9db..e42717825 100644
--- a/arbitrum-docs/run-arbitrum-node/01-overview.md
+++ b/arbitrum-docs/run-arbitrum-node/01-overview.md
@@ -6,7 +6,7 @@ author: mahsamoosavi
In order to be able to _interact with_ or _build applications on_ any of the Arbitrum chains, you need access to the corresponding Arbitrum node. Options are:
-- You can use third party node providers (see the list [here](/build-decentralized-apps/reference/01-node-providers.md)) to get RPC access to fully-managed nodes
+- You can use third party node providers (see the list [here](/build-decentralized-apps/reference/01-node-providers.mdx)) to get RPC access to fully-managed nodes
- You can run your own Arbitrum node, especially if you want to always know the state of the Arbitrum chain
Here, you can find resources that help you run different types of Arbitrum nodes:
diff --git a/arbitrum-docs/run-arbitrum-node/02-quickstart.md b/arbitrum-docs/run-arbitrum-node/02-quickstart.md
index 32a65809c..b835576e8 100644
--- a/arbitrum-docs/run-arbitrum-node/02-quickstart.md
+++ b/arbitrum-docs/run-arbitrum-node/02-quickstart.md
@@ -9,7 +9,7 @@ content_type: quickstart
:::info
-There is no protocol level incentive to run an Arbitum full node. If you’re interested in accessing an Arbitrum chain, but you don’t want to set up your own node, see our [RPC endpoints and providers](/build-decentralized-apps/reference/01-node-providers.md) to get RPC access to fully-managed nodes hosted by a third party provider.
+There is no protocol level incentive to run an Arbitum full node. If you’re interested in accessing an Arbitrum chain, but you don’t want to set up your own node, see our [RPC endpoints and providers](/build-decentralized-apps/reference/01-node-providers.mdx) to get RPC access to fully-managed nodes hosted by a third party provider.
:::
diff --git a/arbitrum-docs/run-arbitrum-node/03-run-full-node.md b/arbitrum-docs/run-arbitrum-node/03-run-full-node.md
index d254dcd17..50eebb6c8 100644
--- a/arbitrum-docs/run-arbitrum-node/03-run-full-node.md
+++ b/arbitrum-docs/run-arbitrum-node/03-run-full-node.md
@@ -7,7 +7,7 @@ content_type: how-to
:::info
-There is no protocol-level incentive to run an Arbitum full node. If you’re interested in accessing an Arbitrum chain but don’t want to set up your own node, see our [Node Providers](/build-decentralized-apps/reference/01-node-providers.md) to get RPC access to fully managed nodes hosted by a third-party provider.
+There is no protocol-level incentive to run an Arbitum full node. If you’re interested in accessing an Arbitrum chain but don’t want to set up your own node, see our [Node Providers](/build-decentralized-apps/reference/01-node-providers.mdx) to get RPC access to fully managed nodes hosted by a third-party provider.
:::
@@ -61,7 +61,7 @@ Even though there are alpha and beta versions of the ` to set the L2 chain from its chain id. See [RPC endpoints and providers](/build-decentralized-apps/reference/01-node-providers.md#rpc-endpoints) for a list of Arbitrum chains and their respective L2 chain IDs.
+ - Use the parameter `--chain.id=` to set the L2 chain from its chain id. See [RPC endpoints and providers](/build-decentralized-apps/reference/01-node-providers.mdx#rpc-endpoints) for a list of Arbitrum chains and their respective L2 chain IDs.
- Alternatively, you can use the parameter `--chain.name=` to set the L2 chain from its name (options are: `arb1`, `nova` and `sepolia-rollup`)
- Note: this parameter was called --l2.chain-id and only accepted chain IDs in versions before `v2.1.0`
diff --git a/arbitrum-docs/run-arbitrum-node/data-availability-committees/02-deploy-das.md b/arbitrum-docs/run-arbitrum-node/data-availability-committees/02-deploy-das.md
index d7c26bf2d..0411cc960 100644
--- a/arbitrum-docs/run-arbitrum-node/data-availability-committees/02-deploy-das.md
+++ b/arbitrum-docs/run-arbitrum-node/data-availability-committees/02-deploy-das.md
@@ -81,7 +81,7 @@ DA servers also have an optional REST aggregator which, when a data batch is not
Gather the following information:
- The latest Nitro docker image: `@latestNitroNodeImage@`
-- An RPC endpoint for the parent chain. It is recommended to use a [third-party provider RPC](/build-decentralized-apps/reference/01-node-providers.md#third-party-rpc-providers) or [run your own node](/node-running/how-tos/running-an-orbit-node.mdx) to prevent being rate limited.
+- An RPC endpoint for the parent chain. It is recommended to use a [third-party provider RPC](/build-decentralized-apps/reference/01-node-providers.mdx#third-party-rpc-providers) or [run your own node](/node-running/how-tos/running-an-orbit-node.mdx) to prevent being rate limited.
- The SequencerInbox contract address in the parent chain.
- If you wish to configure a [REST aggregator for your DAS](#state-synchronization), you'll need the URL where the list of REST endpoints is kept.
diff --git a/arbitrum-docs/run-arbitrum-node/data-availability-committees/03-deploy-mirror-das.md b/arbitrum-docs/run-arbitrum-node/data-availability-committees/03-deploy-mirror-das.md
index 03061df1a..30df7e59f 100644
--- a/arbitrum-docs/run-arbitrum-node/data-availability-committees/03-deploy-mirror-das.md
+++ b/arbitrum-docs/run-arbitrum-node/data-availability-committees/03-deploy-mirror-das.md
@@ -46,7 +46,7 @@ A mirror DAS will use the same tool and, thus, the same configuration options as
Gather the following information:
- The latest Nitro docker image: `@latestNitroNodeImage@`
-- An RPC endpoint for the parent chain. It is recommended to use a [third-party provider RPC](/build-decentralized-apps/reference/01-node-providers.md#third-party-rpc-providers) or [run your own node](/node-running/how-tos/running-an-orbit-node.mdx) to prevent being rate limited.
+- An RPC endpoint for the parent chain. It is recommended to use a [third-party provider RPC](/build-decentralized-apps/reference/01-node-providers.mdx#third-party-rpc-providers) or [run your own node](/node-running/how-tos/running-an-orbit-node.mdx) to prevent being rate limited.
- The SequencerInbox contract address in the parent chain.
- URL of the list of REST endpoints of other DA servers to configure the REST aggregator.
diff --git a/arbitrum-docs/run-arbitrum-node/more-types/01-run-archive-node.md b/arbitrum-docs/run-arbitrum-node/more-types/01-run-archive-node.md
index a8272ecd5..170ab6078 100644
--- a/arbitrum-docs/run-arbitrum-node/more-types/01-run-archive-node.md
+++ b/arbitrum-docs/run-arbitrum-node/more-types/01-run-archive-node.md
@@ -22,7 +22,7 @@ Running an Arbitrum One **full node** in **archive mode** lets you access both p
| Use case | Required node type(s) | Docs |
| ------------------------------------------------------------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
-| Access the **Arbitrum network** without running your own node | Fully managed by third-parties, exposed via RPC endpoints | [RPC endpoints and providers](/build-decentralized-apps/reference/01-node-providers.md) |
+| Access the **Arbitrum network** without running your own node | Fully managed by third-parties, exposed via RPC endpoints | [RPC endpoints and providers](/build-decentralized-apps/reference/01-node-providers.mdx) |
| Run an **archive node** for **Arbitrum Sepolia (testnet)** or **Arbitrum Nova** | Full node (Nitro) | [How to run a full node (Nitro)](/run-arbitrum-node/03-run-full-node.md) |
| Send **post-Nitro** archive requests | Full node (Nitro) | [How to run a full node (Nitro)](/run-arbitrum-node/03-run-full-node.md) |
| Send **pre-Nitro** archive requests | Full node (Classic) | [How to run a full node (Classic, pre-Nitro)](/run-arbitrum-node/more-types/03-run-classic-node.md) |
@@ -72,8 +72,8 @@ The minimum storage requirements will change as the Nitro chains grow (growing r
| Arbitrum Nitro | Arbitrum Classic | Description |
| ---------------------------------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `--parent-chain.connection.url=` | `--l1.url=` | Provide an standard L1 node RPC endpoint that you run yourself or from a third-party node provider (see [RPC endpoints and providers](/build-decentralized-apps/reference/01-node-providers.md)) |
-| `--chain.id=` | `--l2.chain-id=` | See [RPC endpoints and providers](/build-decentralized-apps/reference/01-node-providers.md) for a list of Arbitrum chains and the respective L2 chain IDs |
+| `--parent-chain.connection.url=` | `--l1.url=` | Provide an standard L1 node RPC endpoint that you run yourself or from a third-party node provider (see [RPC endpoints and providers](/build-decentralized-apps/reference/01-node-providers.mdx)) |
+| `--chain.id=` | `--l2.chain-id=` | See [RPC endpoints and providers](/build-decentralized-apps/reference/01-node-providers.mdx) for a list of Arbitrum chains and the respective L2 chain IDs |
| `--execution.caching.archive` | `--node.caching.archive` | Required for running an **Arbitrum One Nitro** archival node and retains past block state |
| - | `--node.cache.allow-slow-lookup` | Required for running an **Arbitrum One Classic** archival node. When this option is present, it will load old blocks from disk if not in memory cache. |
| - | `--core.checkpoint-gas-frequency=156250000` | Required for running an **Arbitrum One Classic** archival node. |