[doc] updated content for mdbook-doxygen

Signed-off-by: Hugo McNally <hugo.mcnally@gmail.com>
diff --git a/SUMMARY.md b/SUMMARY.md
index b82cca9..13114a2 100644
--- a/SUMMARY.md
+++ b/SUMMARY.md
@@ -14,13 +14,16 @@
   - [Alert Handler](./hw/top_earlgrey/ip_autogen/alert_handler/README.md)
     - [Design Verification](./hw/top_earlgrey/ip_autogen/alert_handler/dv/README.md)
     - [Interface and Registers](./hw/top_earlgrey/ip_autogen/alert_handler/data/alert_handler.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_alert_handler.h)
     - [Checklist](./hw/top_earlgrey/ip_autogen/alert_handler/doc/checklist.md)
   - [Interrupt Controller](./hw/top_earlgrey/ip_autogen/rv_plic/README.md)
     - [Design Verification](./hw/top_earlgrey/ip_autogen/rv_plic/doc/dv/README.md)
     - [Interface and Registers](./hw/top_earlgrey/ip_autogen/rv_plic/data/rv_plic.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_rv_plic.h)
     - [Checklist](./hw/top_earlgrey/ip_autogen/rv_plic/doc/checklist.md)
   - [Sensor Control](./hw/top_earlgrey/ip/sensor_ctrl/README.md)
     - [Interface and Registers](./hw/top_earlgrey/ip/sensor_ctrl/data/sensor_ctrl.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_sensor_ctrl.h)
     - [Checklist](./hw/top_earlgrey/ip/sensor_ctrl/doc/checklist.md)
   - [TL-UL Checklist](./hw/top_earlgrey/ip/xbar/doc/checklist.md)
   - [Pinmux Targets](./hw/top_earlgrey/ip/pinmux/doc/autogen/targets.md)
@@ -56,82 +59,102 @@
   - [AES](./hw/ip/aes/README.md)
     - [Design Verification](./hw/ip/aes/dv/README.md)
     - [Interface and Registers](./hw/ip/aes/data/aes.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_aes.h)
     - [Checklist](./hw/ip/aes/doc/checklist.md)
   - [AON Timer](./hw/ip/aon_timer/README.md)
     - [Design Verification](./hw/ip/aon_timer/dv/README.md)
     - [Interface and Registers](./hw/ip/aon_timer/data/aon_timer.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_aon_timer.h)
     - [Checklist](./hw/ip/aon_timer/doc/checklist.md)
   - [Clock Manager](./hw/ip/clkmgr/README.md)
     - [Design Verification](./hw/ip/clkmgr/dv/README.md)
     - [Interface and Registers](./hw/top_earlgrey/ip/clkmgr/data/autogen/clkmgr.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_clkmgr.h)
     - [Checklist](./hw/ip/clkmgr/doc/checklist.md)
   - [CSRNG](./hw/ip/csrng/README.md)
     - [Design Verification](./hw/ip/csrng/dv/README.md)
     - [Interface and Registers](./hw/ip/csrng/data/csrng.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_csrng.h)
     - [Checklist](./hw/ip/csrng/doc/checklist.md)
   - [EDN](./hw/ip/edn/README.md)
     - [Design Verification](./hw/ip/edn/dv/README.md)
     - [Interface and Registers](./hw/ip/edn/data/edn.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_edn.h)
     - [Checklist](./hw/ip/edn/doc/checklist.md)
   - [Entropy Source](./hw/ip/entropy_src/README.md)
     - [Design Verification](./hw/ip/entropy_src/dv/README.md)
     - [Interface and Registers](./hw/ip/entropy_src/data/entropy_src.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_entropy_src.h)
     - [Checklist](./hw/ip/entropy_src/doc/checklist.md)
   - [Flash Controller](./hw/ip/flash_ctrl/README.md)
     - [Design Verification](./hw/ip/flash_ctrl/dv/README.md)
     - [Interface and Registers](./hw/ip/flash_ctrl/data/flash_ctrl.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_flash_ctrl.h)
     - [Checklist](./hw/ip/flash_ctrl/doc/checklist.md)
   - [GPIO](./hw/ip/gpio/README.md)
     - [Design Verification](./hw/ip/gpio/dv/README.md)
     - [Interface and Registers](./hw/ip/gpio/data/gpio.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_gpio.h)
     - [Checklist](./hw/ip/gpio/doc/checklist.md)
   - [HMAC](./hw/ip/hmac/README.md)
     - [Design Verification](./hw/ip/hmac/dv/README.md)
     - [Interface and Registers](./hw/ip/hmac/data/hmac.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_hmac.h)
     - [Checklist](./hw/ip/hmac/doc/checklist.md)
   - [I2C](./hw/ip/i2c/README.md)
     - [Design Verification](./hw/ip/i2c/dv/README.md)
     - [Interface and Registers](./hw/ip/i2c/data/i2c.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_i2c.h)
     - [Checklist](./hw/ip/i2c/doc/checklist.md)
   - [Key Manager](./hw/ip/keymgr/README.md)
     - [Design Verification](./hw/ip/keymgr/dv/README.md)
     - [Interface and Registers](./hw/ip/keymgr/data/keymgr.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_keymgr.h)
     - [Checklist](./hw/ip/keymgr/doc/checklist.md)
   - [KMAC](./hw/ip/kmac/README.md)
     - [Design Verification](./hw/ip/kmac/dv/README.md)
     - [Interface and Registers](./hw/ip/kmac/data/kmac.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_kmac.h)
     - [Checklist](./hw/ip/kmac/doc/checklist.md)
   - [Life Cycle Controller](./hw/ip/lc_ctrl/README.md)
     - [Design Verification](./hw/ip/lc_ctrl/dv/README.md)
     - [Interface and Registers](./hw/ip/lc_ctrl/data/lc_ctrl.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_lc_ctrl.h)
     - [Checklist](./hw/ip/lc_ctrl/doc/checklist.md)
   - [OTP Controller](./hw/ip/otp_ctrl/README.md)
     - [Design Verification](./hw/ip/otp_ctrl/dv/README.md)
     - [Interface and Registers](./hw/ip/otp_ctrl/data/otp_ctrl.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_otp_ctrl.h)
     - [Checklist](./hw/ip/otp_ctrl/doc/checklist.md)
   - [Pattern Generator](./hw/ip/pattgen/README.md)
     - [Design Verification](./hw/ip/pattgen/dv/README.md)
     - [Interface and Registers](./hw/ip/pattgen/data/pattgen.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_pattgen.h)
     - [Checklist](./hw/ip/pattgen/doc/checklist.md)
   - [Pinmux](./hw/ip/pinmux/README.md)
     - [Design Verification](./hw/ip/pinmux/doc/dv/README.md)
     - [Interface and Registers](./hw/top_earlgrey/ip/pinmux/data/autogen/pinmux.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_pinmux.h)
     - [Checklist](./hw/ip/pinmux/doc/checklist.md)
   - [Pulse Width Modulator](./hw/ip/pwm/README.md)
     - [Design Verification](./hw/ip/pwm/dv/README.md)
     - [Interface and Registers](./hw/ip/pwm/data/pwm.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_pwm.h)
     - [Checklist](./hw/ip/pwm/doc/checklist.md)
   - [Power Management](./hw/ip/pwrmgr/README.md)
     - [Design Verification](./hw/ip/pwrmgr/dv/README.md)
     - [Interface and Registers](./hw/top_earlgrey/ip/pwrmgr/data/autogen/pwrmgr.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_pwrmgr.h)
     - [Checklist](./hw/ip/pwrmgr/doc/checklist.md)
   - [ROM Control](./hw/ip/rom_ctrl/README.md)
     - [Design Verification](./hw/ip/rom_ctrl/dv/README.md)
     - [Interface and Registers](./hw/ip/rom_ctrl/data/rom_ctrl.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_rom_ctrl.h)
     - [Checklist](./hw/ip/rom_ctrl/doc/checklist.md)
   - [Reset Manager](./hw/ip/rstmgr/README.md)
     - [Design Verification](./hw/ip/rstmgr/dv/README.md)
     - [Interface and Registers](./hw/top_earlgrey/ip/rstmgr/data/autogen/rstmgr.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_rstmgr.h)
     - [Checklist](./hw/ip/rstmgr/doc/checklist.md)
   - [RISC-V Debug Manager](./hw/ip/rv_dm/README.md)
     - [Design Verification](./hw/ip/rv_dm/dv/README.md)
@@ -140,22 +163,27 @@
   - [SPI Device](./hw/ip/spi_device/README.md)
     - [Design Verification](./hw/ip/spi_device/dv/README.md)
     - [Interface and Registers](./hw/ip/spi_device/data/spi_device.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_spi_device.h)
     - [Checklist](./hw/ip/spi_device/doc/checklist.md)
   - [SPI Host](./hw/ip/spi_host/README.md)
     - [Design Verification](./hw/ip/spi_host/dv/README.md)
     - [Interface and Registers](./hw/ip/spi_host/data/spi_host.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_spi_host.h)
     - [Checklist](./hw/ip/spi_host/doc/checklist.md)
   - [SRAM Controller](./hw/ip/sram_ctrl/README.md)
     - [Design Verification](./hw/ip/sram_ctrl/dv/README.md)
     - [Interface and Registers](./hw/ip/sram_ctrl/data/sram_ctrl.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_sram_ctrl.h)
     - [Checklist](./hw/ip/sram_ctrl/doc/checklist.md)
   - [System Reset Controller](./hw/ip/sysrst_ctrl/README.md)
     - [Design Verification](./hw/ip/sysrst_ctrl/dv/README.md)
     - [Interface and Registers](./hw/ip/sysrst_ctrl/data/sysrst_ctrl.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_sysrst_ctrl.h)
     - [Checklist](./hw/ip/sysrst_ctrl/doc/checklist.md)
   - [Timer](./hw/ip/rv_timer/README.md)
     - [Design Verification](./hw/ip/rv_timer/dv/README.md)
     - [Interface and Registers](./hw/ip/rv_timer/data/rv_timer.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_rv_timer.h)
     - [Checklist](./hw/ip/rv_timer/doc/checklist.md)
   - [TL-UL Bus](./hw/ip/tlul/README.md)
     - [Design Verification](./hw/ip/tlul/doc/dv/README.md)
@@ -163,11 +191,13 @@
   - [UART](./hw/ip/uart/README.md)
     - [Design Verification](./hw/ip/uart/dv/README.md)
     - [Interface and Registers](./hw/ip/uart/data/uart.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_uart.h)
     - [Checklist](./hw/ip/uart/doc/checklist.md)
   - [USB 2.0](./hw/ip/usbdev/README.md)
     - [Design Verification](./hw/ip/usbdev/dv/README.md)
     - [Suspending and Resuming](./hw/ip/usbdev/doc/wake_resume.md)
     - [Interface and Registers](./hw/ip/usbdev/data/usbdev.hjson)
+    - [Device Interface Functions](./sw/device/lib/dif/dif_usbdev.h)
     - [Checklist](./hw/ip/usbdev/doc/checklist.md)
   - [lowRISC Hardware Primitives](./hw/ip/prim/README.md)
     - [Two Input Clock](./hw/ip/prim/doc/prim_clock_gp_mux2.md)
diff --git a/hw/ip/adc_ctrl/README.md b/hw/ip/adc_ctrl/README.md
index 477b86b..e6d3962 100644
--- a/hw/ip/adc_ctrl/README.md
+++ b/hw/ip/adc_ctrl/README.md
@@ -258,7 +258,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_adc_ctrl.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_adc_ctrl.h)
 
 ## Registers
 
diff --git a/hw/ip/aes/README.md b/hw/ip/aes/README.md
index 899eae1..e624aed 100644
--- a/hw/ip/aes/README.md
+++ b/hw/ip/aes/README.md
@@ -621,7 +621,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_aes.h" >}}
+* [DIF Listings](../../../sw/device/lib/dif/dif_aes.h)
 
 ## Register Table
 
diff --git a/hw/ip/aon_timer/README.md b/hw/ip/aon_timer/README.md
index 44d4280..168200b 100644
--- a/hw/ip/aon_timer/README.md
+++ b/hw/ip/aon_timer/README.md
@@ -112,7 +112,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_aon_timer.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_aon_timer.h)
 
 ## Register Table
 
diff --git a/hw/ip/clkmgr/README.md b/hw/ip/clkmgr/README.md
index a083fec..c42fa93 100644
--- a/hw/ip/clkmgr/README.md
+++ b/hw/ip/clkmgr/README.md
@@ -317,7 +317,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_clkmgr.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_clkmgr.h)
 
 ## Register Table
 
diff --git a/hw/ip/csrng/README.md b/hw/ip/csrng/README.md
index 14868f2..5d8f760 100644
--- a/hw/ip/csrng/README.md
+++ b/hw/ip/csrng/README.md
@@ -700,7 +700,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_csrng.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_csrng.h)
 
 ## Register Table
 
diff --git a/hw/ip/edn/README.md b/hw/ip/edn/README.md
index d48764a..0a62b06 100644
--- a/hw/ip/edn/README.md
+++ b/hw/ip/edn/README.md
@@ -268,7 +268,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_edn.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_edn.h)
 
 ## Register Table
 
diff --git a/hw/ip/entropy_src/README.md b/hw/ip/entropy_src/README.md
index 3808306..12d971e 100644
--- a/hw/ip/entropy_src/README.md
+++ b/hw/ip/entropy_src/README.md
@@ -434,7 +434,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_entropy_src.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_entropy_src.h)
 
 ## Register Table
 
diff --git a/hw/ip/flash_ctrl/README.md b/hw/ip/flash_ctrl/README.md
index 90f512f..328da54 100644
--- a/hw/ip/flash_ctrl/README.md
+++ b/hw/ip/flash_ctrl/README.md
@@ -792,7 +792,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_flash_ctrl.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_flash_ctrl.h)
 
 ## Register Table
 
diff --git a/hw/ip/gpio/README.md b/hw/ip/gpio/README.md
index 85b13c6..7496e23 100644
--- a/hw/ip/gpio/README.md
+++ b/hw/ip/gpio/README.md
@@ -275,7 +275,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_gpio.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_gpio.h)
 
 ## Register Table
 
diff --git a/hw/ip/hmac/README.md b/hw/ip/hmac/README.md
index e74ba0a..1c1b882 100644
--- a/hw/ip/hmac/README.md
+++ b/hw/ip/hmac/README.md
@@ -331,7 +331,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_hmac.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_hmac.h)
 
 ## Register Table
 
diff --git a/hw/ip/i2c/README.md b/hw/ip/i2c/README.md
index 8682cb5..6effc15 100644
--- a/hw/ip/i2c/README.md
+++ b/hw/ip/i2c/README.md
@@ -486,7 +486,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_i2c.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_i2c.h)
 
 ## Register Table
 
diff --git a/hw/ip/keymgr/README.md b/hw/ip/keymgr/README.md
index 84dd787..2b85374 100644
--- a/hw/ip/keymgr/README.md
+++ b/hw/ip/keymgr/README.md
@@ -543,7 +543,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_keymgr.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_keymgr.h)
 
 ## Register Table
 
diff --git a/hw/ip/kmac/README.md b/hw/ip/kmac/README.md
index 0339af0..5c7eb31 100644
--- a/hw/ip/kmac/README.md
+++ b/hw/ip/kmac/README.md
@@ -511,7 +511,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_kmac.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_kmac.h)
 
 ## Registers
 
diff --git a/hw/ip/lc_ctrl/README.md b/hw/ip/lc_ctrl/README.md
index c90ad7f..1f24217 100644
--- a/hw/ip/lc_ctrl/README.md
+++ b/hw/ip/lc_ctrl/README.md
@@ -678,7 +678,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_lc_ctrl.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_lc_ctrl.h)
 
 ## Register Table
 
diff --git a/hw/ip/otbn/README.md b/hw/ip/otbn/README.md
index f68b8e2..72fe0e5 100644
--- a/hw/ip/otbn/README.md
+++ b/hw/ip/otbn/README.md
@@ -1108,7 +1108,7 @@
 
 ## Device Interface Functions (DIFs) {#dif}
 
-{{< dif_listing "sw/device/lib/dif/dif_otbn.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_otbn.h)
 
 ## Driver {#driver}
 
diff --git a/hw/ip/otp_ctrl/README.md b/hw/ip/otp_ctrl/README.md
index 7000147..98cea74 100644
--- a/hw/ip/otp_ctrl/README.md
+++ b/hw/ip/otp_ctrl/README.md
@@ -985,7 +985,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_otp_ctrl.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_otp_ctrl.h)
 
 ## Register Table
 
diff --git a/hw/ip/pattgen/README.md b/hw/ip/pattgen/README.md
index f3d15b6..21bc7cb 100644
--- a/hw/ip/pattgen/README.md
+++ b/hw/ip/pattgen/README.md
@@ -136,7 +136,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_pattgen.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_pattgen.h)
 
 ## Register Table
 
diff --git a/hw/ip/pinmux/README.md b/hw/ip/pinmux/README.md
index 91c675c..8b38d46 100644
--- a/hw/ip/pinmux/README.md
+++ b/hw/ip/pinmux/README.md
@@ -376,7 +376,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_pinmux.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_pinmux.h)
 
 ## Register Table
 
diff --git a/hw/ip/pwm/README.md b/hw/ip/pwm/README.md
index 8a5af96..dcb7b24 100644
--- a/hw/ip/pwm/README.md
+++ b/hw/ip/pwm/README.md
@@ -313,7 +313,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_pwm.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_pwm.h)
 
 ## Register Table
 
diff --git a/hw/ip/pwrmgr/README.md b/hw/ip/pwrmgr/README.md
index b788858..02f1b86 100644
--- a/hw/ip/pwrmgr/README.md
+++ b/hw/ip/pwrmgr/README.md
@@ -405,7 +405,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_pwrmgr.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_pwrmgr.h)
 
 ## Register Table
 
diff --git a/hw/ip/rom_ctrl/README.md b/hw/ip/rom_ctrl/README.md
index 92307e5..0252b82 100644
--- a/hw/ip/rom_ctrl/README.md
+++ b/hw/ip/rom_ctrl/README.md
@@ -234,7 +234,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_rom_ctrl.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_rom_ctrl.h)
 
 ## Register Table
 
diff --git a/hw/ip/rstmgr/README.md b/hw/ip/rstmgr/README.md
index c3f5d3f..21955f4 100644
--- a/hw/ip/rstmgr/README.md
+++ b/hw/ip/rstmgr/README.md
@@ -342,7 +342,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_rstmgr.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_rstmgr.h)
 
 ## Register Table
 
diff --git a/hw/ip/rv_core_ibex/README.md b/hw/ip/rv_core_ibex/README.md
index dc36742..a9a9a4a 100644
--- a/hw/ip/rv_core_ibex/README.md
+++ b/hw/ip/rv_core_ibex/README.md
@@ -186,7 +186,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_rv_core_ibex.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_rv_core_ibex.h)
 
 ## Register Table
 
diff --git a/hw/ip/rv_timer/README.md b/hw/ip/rv_timer/README.md
index 3dd4ca0..c015f4b 100644
--- a/hw/ip/rv_timer/README.md
+++ b/hw/ip/rv_timer/README.md
@@ -240,7 +240,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_rv_timer.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_rv_timer.h)
 
 ## Register Table
 
diff --git a/hw/ip/spi_device/README.md b/hw/ip/spi_device/README.md
index 841e5f9..7f53fdd 100644
--- a/hw/ip/spi_device/README.md
+++ b/hw/ip/spi_device/README.md
@@ -949,7 +949,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_spi_device.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_spi_device.h)
 
 ## Register Table
 
diff --git a/hw/ip/spi_host/README.md b/hw/ip/spi_host/README.md
index ce41303..be00e7b 100644
--- a/hw/ip/spi_host/README.md
+++ b/hw/ip/spi_host/README.md
@@ -1415,7 +1415,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_spi_host.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_spi_host.h)
 
 ## Register Table
 
diff --git a/hw/ip/sram_ctrl/README.md b/hw/ip/sram_ctrl/README.md
index 3ba81dd..4aa550b 100644
--- a/hw/ip/sram_ctrl/README.md
+++ b/hw/ip/sram_ctrl/README.md
@@ -227,7 +227,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_sram_ctrl.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_sram_ctrl.h)
 
 ## Register Table
 
diff --git a/hw/ip/sysrst_ctrl/README.md b/hw/ip/sysrst_ctrl/README.md
index 82732b9..1fe44d4 100644
--- a/hw/ip/sysrst_ctrl/README.md
+++ b/hw/ip/sysrst_ctrl/README.md
@@ -197,7 +197,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_sysrst_ctrl.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_sysrst_ctrl.h)
 
 ## Registers
 
diff --git a/hw/ip/uart/README.md b/hw/ip/uart/README.md
index df6fb88..f9b0749 100644
--- a/hw/ip/uart/README.md
+++ b/hw/ip/uart/README.md
@@ -479,7 +479,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_uart.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_uart.h)
 
 ## Register Table
 
diff --git a/hw/ip/usbdev/README.md b/hw/ip/usbdev/README.md
index 43c153f..99dc6ad 100644
--- a/hw/ip/usbdev/README.md
+++ b/hw/ip/usbdev/README.md
@@ -351,7 +351,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_usbdev.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_usbdev.h)
 
 ## Register Table
 
diff --git a/hw/ip_templates/alert_handler/README.md b/hw/ip_templates/alert_handler/README.md
index be952d6..3f1a478 100644
--- a/hw/ip_templates/alert_handler/README.md
+++ b/hw/ip_templates/alert_handler/README.md
@@ -951,7 +951,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_alert_handler.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_alert_handler.h)
 
 ## Register Table
 
diff --git a/hw/ip_templates/rv_plic/README.md b/hw/ip_templates/rv_plic/README.md
index 644cd48..bd1c50d 100644
--- a/hw/ip_templates/rv_plic/README.md
+++ b/hw/ip_templates/rv_plic/README.md
@@ -224,7 +224,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_rv_plic.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_rv_plic.h)
 
 ## Registers
 
diff --git a/hw/top_earlgrey/ip/sensor_ctrl/README.md b/hw/top_earlgrey/ip/sensor_ctrl/README.md
index 5809525..82f574a 100644
--- a/hw/top_earlgrey/ip/sensor_ctrl/README.md
+++ b/hw/top_earlgrey/ip/sensor_ctrl/README.md
@@ -63,7 +63,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_sensor_ctrl.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_sensor_ctrl.h)
 
 ## Register Table
 
diff --git a/hw/top_earlgrey/ip_autogen/alert_handler/README.md b/hw/top_earlgrey/ip_autogen/alert_handler/README.md
index 8c0411e..f781945 100644
--- a/hw/top_earlgrey/ip_autogen/alert_handler/README.md
+++ b/hw/top_earlgrey/ip_autogen/alert_handler/README.md
@@ -951,7 +951,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_alert_handler.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_alert_handler.h)
 
 ## Register Table
 
diff --git a/hw/top_earlgrey/ip_autogen/rv_plic/README.md b/hw/top_earlgrey/ip_autogen/rv_plic/README.md
index 72de044..2f8e25b 100644
--- a/hw/top_earlgrey/ip_autogen/rv_plic/README.md
+++ b/hw/top_earlgrey/ip_autogen/rv_plic/README.md
@@ -224,7 +224,7 @@
 
 ## Device Interface Functions (DIFs)
 
-{{< dif_listing "sw/device/lib/dif/dif_rv_plic.h" >}}
+- [Device Interface Functions](../../../sw/device/lib/dif/dif_rv_plic.h)
 
 ## Registers