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..7924632cf 100644
--- a/arbitrum-docs/build-decentralized-apps/01-quickstart-solidity-hardhat.mdx
+++ b/arbitrum-docs/build-decentralized-apps/01-quickstart-solidity-hardhat.mdx
@@ -520,7 +520,7 @@ If you have any questions or feedback, reach out to us on [Discord](https://disc
 [^3]: There are multiple types of Ethereum nodes. The ones that earn ETH for processing and validating transactions are called _validators_. See [Nodes and Networks](https://docs.prylabs.network/docs/concepts/nodes-networks) for a beginner-friendly introduction to Ethereum's node types.
 [^4]: When our `VendingMachine` contract is deployed to Ethereum, it'll be hosted by Ethereum's decentralized network of nodes. Generally speaking, we won't be able to modify the contract's code after it's deployed.
 [^5]: To learn more about how Ethereum wallets work, see [Ethereum.org's introduction to Ethereum wallets](https://ethereum.org/en/wallets/).
-[^6]: Visit the [Gentle Introduction to Arbitrum](../intro/intro.md) for a beginner-friendly introduction to Arbitrum's rollup protocol.
+[^6]: Visit the [Gentle Introduction to Arbitrum](../intro/intro.mdx) for a beginner-friendly introduction to Arbitrum's rollup protocol.
 
 <!-- TODOs
 
diff --git a/arbitrum-docs/for-users/contribute.md b/arbitrum-docs/for-users/contribute.mdx
similarity index 100%
rename from arbitrum-docs/for-users/contribute.md
rename to arbitrum-docs/for-users/contribute.mdx
diff --git a/arbitrum-docs/intro/intro.md b/arbitrum-docs/intro/intro.mdx
similarity index 100%
rename from arbitrum-docs/intro/intro.md
rename to arbitrum-docs/intro/intro.mdx
diff --git a/arbitrum-docs/learn-more/contribute.md b/arbitrum-docs/learn-more/contribute.mdx
similarity index 100%
rename from arbitrum-docs/learn-more/contribute.md
rename to arbitrum-docs/learn-more/contribute.mdx
diff --git a/arbitrum-docs/learn-more/faq.md b/arbitrum-docs/learn-more/faq.mdx
similarity index 100%
rename from arbitrum-docs/learn-more/faq.md
rename to arbitrum-docs/learn-more/faq.mdx
diff --git a/arbitrum-docs/welcome/arbitrum-gentle-introduction.md b/arbitrum-docs/welcome/arbitrum-gentle-introduction.mdx
similarity index 100%
rename from arbitrum-docs/welcome/arbitrum-gentle-introduction.md
rename to arbitrum-docs/welcome/arbitrum-gentle-introduction.mdx
diff --git a/arbitrum-docs/welcome/get-started.md b/arbitrum-docs/welcome/get-started.mdx
similarity index 100%
rename from arbitrum-docs/welcome/get-started.md
rename to arbitrum-docs/welcome/get-started.mdx