diff --git a/examples/lpc/lpc13xx/lpc-p1343/miniblink/README b/examples/lpc/lpc13xx/lpc-p1343/miniblink/README.md
similarity index 100%
rename from examples/lpc/lpc13xx/lpc-p1343/miniblink/README
rename to examples/lpc/lpc13xx/lpc-p1343/miniblink/README.md
diff --git a/examples/lpc/lpc17xx/blueboard-lpc1768-h/miniblink/README b/examples/lpc/lpc17xx/blueboard-lpc1768-h/miniblink/README.md
similarity index 100%
rename from examples/lpc/lpc17xx/blueboard-lpc1768-h/miniblink/README
rename to examples/lpc/lpc17xx/blueboard-lpc1768-h/miniblink/README.md
diff --git a/examples/lpc/lpc43xx/diolan-lpc-4350-db1/README b/examples/lpc/lpc43xx/diolan-lpc-4350-db1/README.md
similarity index 100%
rename from examples/lpc/lpc43xx/diolan-lpc-4350-db1/README
rename to examples/lpc/lpc43xx/diolan-lpc-4350-db1/README.md
diff --git a/examples/lpc/lpc43xx/diolan-lpc-4350-db1/miniblink/README b/examples/lpc/lpc43xx/diolan-lpc-4350-db1/miniblink/README.md
similarity index 100%
rename from examples/lpc/lpc43xx/diolan-lpc-4350-db1/miniblink/README
rename to examples/lpc/lpc43xx/diolan-lpc-4350-db1/miniblink/README.md
diff --git a/examples/lpc/lpc43xx/hackrf-jellybean/README b/examples/lpc/lpc43xx/hackrf-jellybean/README.md
similarity index 100%
rename from examples/lpc/lpc43xx/hackrf-jellybean/README
rename to examples/lpc/lpc43xx/hackrf-jellybean/README.md
diff --git a/examples/lpc/lpc43xx/hackrf-jellybean/i2c/README b/examples/lpc/lpc43xx/hackrf-jellybean/i2c/README.md
similarity index 100%
rename from examples/lpc/lpc43xx/hackrf-jellybean/i2c/README
rename to examples/lpc/lpc43xx/hackrf-jellybean/i2c/README.md
diff --git a/examples/lpc/lpc43xx/hackrf-jellybean/miniblink/README b/examples/lpc/lpc43xx/hackrf-jellybean/miniblink/README.md
similarity index 100%
rename from examples/lpc/lpc43xx/hackrf-jellybean/miniblink/README
rename to examples/lpc/lpc43xx/hackrf-jellybean/miniblink/README.md
diff --git a/examples/lpc/lpc43xx/hackrf-jellybean/miniblink_rom_to_ram/README b/examples/lpc/lpc43xx/hackrf-jellybean/miniblink_rom_to_ram/README.md
similarity index 100%
rename from examples/lpc/lpc43xx/hackrf-jellybean/miniblink_rom_to_ram/README
rename to examples/lpc/lpc43xx/hackrf-jellybean/miniblink_rom_to_ram/README.md
diff --git a/examples/lpc/lpc43xx/hackrf-jellybean/ssp/README b/examples/lpc/lpc43xx/hackrf-jellybean/ssp/README.md
similarity index 100%
rename from examples/lpc/lpc43xx/hackrf-jellybean/ssp/README
rename to examples/lpc/lpc43xx/hackrf-jellybean/ssp/README.md
diff --git a/examples/lpc/lpc43xx/hackrf-jellybean/systick/README b/examples/lpc/lpc43xx/hackrf-jellybean/systick/README.md
similarity index 100%
rename from examples/lpc/lpc43xx/hackrf-jellybean/systick/README
rename to examples/lpc/lpc43xx/hackrf-jellybean/systick/README.md
diff --git a/examples/stm32/f0/stm32f0-discovery/adc/README b/examples/stm32/f0/stm32f0-discovery/adc/README.md
similarity index 100%
rename from examples/stm32/f0/stm32f0-discovery/adc/README
rename to examples/stm32/f0/stm32f0-discovery/adc/README.md
diff --git a/examples/stm32/f0/stm32f0-discovery/button/README b/examples/stm32/f0/stm32f0-discovery/button/README.md
similarity index 100%
rename from examples/stm32/f0/stm32f0-discovery/button/README
rename to examples/stm32/f0/stm32f0-discovery/button/README.md
diff --git a/examples/stm32/f0/stm32f0-discovery/miniblink/README b/examples/stm32/f0/stm32f0-discovery/miniblink/README.md
similarity index 100%
rename from examples/stm32/f0/stm32f0-discovery/miniblink/README
rename to examples/stm32/f0/stm32f0-discovery/miniblink/README.md
diff --git a/examples/stm32/f0/stm32f0-discovery/systick_blink/README b/examples/stm32/f0/stm32f0-discovery/systick_blink/README.md
similarity index 100%
rename from examples/stm32/f0/stm32f0-discovery/systick_blink/README
rename to examples/stm32/f0/stm32f0-discovery/systick_blink/README.md
diff --git a/examples/stm32/f0/stm32f0-discovery/usart/README b/examples/stm32/f0/stm32f0-discovery/usart/README.md
similarity index 100%
rename from examples/stm32/f0/stm32f0-discovery/usart/README
rename to examples/stm32/f0/stm32f0-discovery/usart/README.md
diff --git a/examples/stm32/f0/stm32f0-discovery/usart_stdio/README b/examples/stm32/f0/stm32f0-discovery/usart_stdio/README.md
similarity index 100%
rename from examples/stm32/f0/stm32f0-discovery/usart_stdio/README
rename to examples/stm32/f0/stm32f0-discovery/usart_stdio/README.md
diff --git a/examples/stm32/f1/lisa-m-1/can/README b/examples/stm32/f1/lisa-m-1/can/README.md
similarity index 100%
rename from examples/stm32/f1/lisa-m-1/can/README
rename to examples/stm32/f1/lisa-m-1/can/README.md
diff --git a/examples/stm32/f1/lisa-m-1/usb_cdcacm/README b/examples/stm32/f1/lisa-m-1/usb_cdcacm/README.md
similarity index 100%
rename from examples/stm32/f1/lisa-m-1/usb_cdcacm/README
rename to examples/stm32/f1/lisa-m-1/usb_cdcacm/README.md
diff --git a/examples/stm32/f1/lisa-m-1/usb_dfu/README b/examples/stm32/f1/lisa-m-1/usb_dfu/README.md
similarity index 100%
rename from examples/stm32/f1/lisa-m-1/usb_dfu/README
rename to examples/stm32/f1/lisa-m-1/usb_dfu/README.md
diff --git a/examples/stm32/f1/lisa-m-1/usb_hid/README b/examples/stm32/f1/lisa-m-1/usb_hid/README.md
similarity index 100%
rename from examples/stm32/f1/lisa-m-1/usb_hid/README
rename to examples/stm32/f1/lisa-m-1/usb_hid/README.md
diff --git a/examples/stm32/f1/lisa-m-2/adc_injec/README b/examples/stm32/f1/lisa-m-2/adc_injec/README.md
similarity index 100%
rename from examples/stm32/f1/lisa-m-2/adc_injec/README
rename to examples/stm32/f1/lisa-m-2/adc_injec/README.md
diff --git a/examples/stm32/f1/lisa-m-2/adc_injec_timtrig/README b/examples/stm32/f1/lisa-m-2/adc_injec_timtrig/README.md
similarity index 100%
rename from examples/stm32/f1/lisa-m-2/adc_injec_timtrig/README
rename to examples/stm32/f1/lisa-m-2/adc_injec_timtrig/README.md
diff --git a/examples/stm32/f1/lisa-m-2/adc_injec_timtrig_irq/README b/examples/stm32/f1/lisa-m-2/adc_injec_timtrig_irq/README.md
similarity index 100%
rename from examples/stm32/f1/lisa-m-2/adc_injec_timtrig_irq/README
rename to examples/stm32/f1/lisa-m-2/adc_injec_timtrig_irq/README.md
diff --git a/examples/stm32/f1/lisa-m-2/adc_injec_timtrig_irq_4ch/README b/examples/stm32/f1/lisa-m-2/adc_injec_timtrig_irq_4ch/README.md
similarity index 100%
rename from examples/stm32/f1/lisa-m-2/adc_injec_timtrig_irq_4ch/README
rename to examples/stm32/f1/lisa-m-2/adc_injec_timtrig_irq_4ch/README.md
diff --git a/examples/stm32/f1/lisa-m-2/adc_regular/README b/examples/stm32/f1/lisa-m-2/adc_regular/README.md
similarity index 100%
rename from examples/stm32/f1/lisa-m-2/adc_regular/README
rename to examples/stm32/f1/lisa-m-2/adc_regular/README.md
diff --git a/examples/stm32/f1/lisa-m-2/can/README b/examples/stm32/f1/lisa-m-2/can/README.md
similarity index 100%
rename from examples/stm32/f1/lisa-m-2/can/README
rename to examples/stm32/f1/lisa-m-2/can/README.md
diff --git a/examples/stm32/f1/lisa-m-2/spi/README b/examples/stm32/f1/lisa-m-2/spi/README.md
similarity index 100%
rename from examples/stm32/f1/lisa-m-2/spi/README
rename to examples/stm32/f1/lisa-m-2/spi/README.md
diff --git a/examples/stm32/f1/lisa-m-2/spi_dma/README b/examples/stm32/f1/lisa-m-2/spi_dma/README.md
similarity index 100%
rename from examples/stm32/f1/lisa-m-2/spi_dma/README
rename to examples/stm32/f1/lisa-m-2/spi_dma/README.md
diff --git a/examples/stm32/f1/lisa-m-2/spi_dma_adv/README b/examples/stm32/f1/lisa-m-2/spi_dma_adv/README.md
similarity index 100%
rename from examples/stm32/f1/lisa-m-2/spi_dma_adv/README
rename to examples/stm32/f1/lisa-m-2/spi_dma_adv/README.md
diff --git a/examples/stm32/f1/lisa-m-2/usart/README b/examples/stm32/f1/lisa-m-2/usart/README.md
similarity index 100%
rename from examples/stm32/f1/lisa-m-2/usart/README
rename to examples/stm32/f1/lisa-m-2/usart/README.md
diff --git a/examples/stm32/f1/mb525/fancyblink/README b/examples/stm32/f1/mb525/fancyblink/README.md
similarity index 100%
rename from examples/stm32/f1/mb525/fancyblink/README
rename to examples/stm32/f1/mb525/fancyblink/README.md
diff --git a/examples/stm32/f1/mb525/pwmleds/README b/examples/stm32/f1/mb525/pwmleds/README.md
similarity index 100%
rename from examples/stm32/f1/mb525/pwmleds/README
rename to examples/stm32/f1/mb525/pwmleds/README.md
diff --git a/examples/stm32/f1/obldc-strip/can/README b/examples/stm32/f1/obldc-strip/can/README.md
similarity index 100%
rename from examples/stm32/f1/obldc-strip/can/README
rename to examples/stm32/f1/obldc-strip/can/README.md
diff --git a/examples/stm32/f1/other/adc_temperature_sensor/README b/examples/stm32/f1/other/adc_temperature_sensor/README.md
similarity index 100%
rename from examples/stm32/f1/other/adc_temperature_sensor/README
rename to examples/stm32/f1/other/adc_temperature_sensor/README.md
diff --git a/examples/stm32/f1/other/dma_mem2mem/README b/examples/stm32/f1/other/dma_mem2mem/README.md
similarity index 100%
rename from examples/stm32/f1/other/dma_mem2mem/README
rename to examples/stm32/f1/other/dma_mem2mem/README.md
diff --git a/examples/stm32/f1/other/dogm128/README b/examples/stm32/f1/other/dogm128/README.md
similarity index 100%
rename from examples/stm32/f1/other/dogm128/README
rename to examples/stm32/f1/other/dogm128/README.md
diff --git a/examples/stm32/f1/other/i2c_stts75_sensor/README b/examples/stm32/f1/other/i2c_stts75_sensor/README.md
similarity index 100%
rename from examples/stm32/f1/other/i2c_stts75_sensor/README
rename to examples/stm32/f1/other/i2c_stts75_sensor/README.md
diff --git a/examples/stm32/f1/other/rtc/README b/examples/stm32/f1/other/rtc/README.md
similarity index 100%
rename from examples/stm32/f1/other/rtc/README
rename to examples/stm32/f1/other/rtc/README.md
diff --git a/examples/stm32/f1/other/systick/README b/examples/stm32/f1/other/systick/README.md
similarity index 100%
rename from examples/stm32/f1/other/systick/README
rename to examples/stm32/f1/other/systick/README.md
diff --git a/examples/stm32/f1/other/timer_interrupt/README b/examples/stm32/f1/other/timer_interrupt/README.md
similarity index 100%
rename from examples/stm32/f1/other/timer_interrupt/README
rename to examples/stm32/f1/other/timer_interrupt/README.md
diff --git a/examples/stm32/f1/other/usb_cdcacm/README b/examples/stm32/f1/other/usb_cdcacm/README.md
similarity index 100%
rename from examples/stm32/f1/other/usb_cdcacm/README
rename to examples/stm32/f1/other/usb_cdcacm/README.md
diff --git a/examples/stm32/f1/other/usb_dfu/README b/examples/stm32/f1/other/usb_dfu/README.md
similarity index 100%
rename from examples/stm32/f1/other/usb_dfu/README
rename to examples/stm32/f1/other/usb_dfu/README.md
diff --git a/examples/stm32/f1/other/usb_hid/README b/examples/stm32/f1/other/usb_hid/README.md
similarity index 100%
rename from examples/stm32/f1/other/usb_hid/README
rename to examples/stm32/f1/other/usb_hid/README.md
diff --git a/examples/stm32/f1/stm32-h103/fancyblink/README b/examples/stm32/f1/stm32-h103/fancyblink/README.md
similarity index 100%
rename from examples/stm32/f1/stm32-h103/fancyblink/README
rename to examples/stm32/f1/stm32-h103/fancyblink/README.md
diff --git a/examples/stm32/f1/stm32-h103/miniblink/README b/examples/stm32/f1/stm32-h103/miniblink/README.md
similarity index 100%
rename from examples/stm32/f1/stm32-h103/miniblink/README
rename to examples/stm32/f1/stm32-h103/miniblink/README.md
diff --git a/examples/stm32/f1/stm32-h103/spi/README b/examples/stm32/f1/stm32-h103/spi/README.md
similarity index 100%
rename from examples/stm32/f1/stm32-h103/spi/README
rename to examples/stm32/f1/stm32-h103/spi/README.md
diff --git a/examples/stm32/f1/stm32-h103/traceswo/README b/examples/stm32/f1/stm32-h103/traceswo/README.md
similarity index 100%
rename from examples/stm32/f1/stm32-h103/traceswo/README
rename to examples/stm32/f1/stm32-h103/traceswo/README.md
diff --git a/examples/stm32/f1/stm32-h103/usart/README b/examples/stm32/f1/stm32-h103/usart/README.md
similarity index 100%
rename from examples/stm32/f1/stm32-h103/usart/README
rename to examples/stm32/f1/stm32-h103/usart/README.md
diff --git a/examples/stm32/f1/stm32-h103/usb_cdcacm/README b/examples/stm32/f1/stm32-h103/usb_cdcacm/README.md
similarity index 100%
rename from examples/stm32/f1/stm32-h103/usb_cdcacm/README
rename to examples/stm32/f1/stm32-h103/usb_cdcacm/README.md
diff --git a/examples/stm32/f1/stm32-h103/usb_dfu/README b/examples/stm32/f1/stm32-h103/usb_dfu/README.md
similarity index 100%
rename from examples/stm32/f1/stm32-h103/usb_dfu/README
rename to examples/stm32/f1/stm32-h103/usb_dfu/README.md
diff --git a/examples/stm32/f1/stm32-h103/usb_hid/README b/examples/stm32/f1/stm32-h103/usb_hid/README.md
similarity index 100%
rename from examples/stm32/f1/stm32-h103/usb_hid/README
rename to examples/stm32/f1/stm32-h103/usb_hid/README.md
diff --git a/examples/stm32/f1/stm32-h103/usb_iap/README b/examples/stm32/f1/stm32-h103/usb_iap/README.md
similarity index 100%
rename from examples/stm32/f1/stm32-h103/usb_iap/README
rename to examples/stm32/f1/stm32-h103/usb_iap/README.md
diff --git a/examples/stm32/f1/stm32-h107/fancyblink/README b/examples/stm32/f1/stm32-h107/fancyblink/README.md
similarity index 100%
rename from examples/stm32/f1/stm32-h107/fancyblink/README
rename to examples/stm32/f1/stm32-h107/fancyblink/README.md
diff --git a/examples/stm32/f1/stm32-h107/flash_rw_example/README b/examples/stm32/f1/stm32-h107/flash_rw_example/README.md
similarity index 100%
rename from examples/stm32/f1/stm32-h107/flash_rw_example/README
rename to examples/stm32/f1/stm32-h107/flash_rw_example/README.md
diff --git a/examples/stm32/f1/stm32-h107/usb_simple/README b/examples/stm32/f1/stm32-h107/usb_simple/README.md
similarity index 100%
rename from examples/stm32/f1/stm32-h107/usb_simple/README
rename to examples/stm32/f1/stm32-h107/usb_simple/README.md
diff --git a/examples/stm32/f1/stm32-maple/miniblink/README b/examples/stm32/f1/stm32-maple/miniblink/README.md
similarity index 100%
rename from examples/stm32/f1/stm32-maple/miniblink/README
rename to examples/stm32/f1/stm32-maple/miniblink/README.md
diff --git a/examples/stm32/f1/stm32-maple/usart/README b/examples/stm32/f1/stm32-maple/usart/README.md
similarity index 100%
rename from examples/stm32/f1/stm32-maple/usart/README
rename to examples/stm32/f1/stm32-maple/usart/README.md
diff --git a/examples/stm32/f1/stm32-maple/usb_cdcacm/README b/examples/stm32/f1/stm32-maple/usb_cdcacm/README.md
similarity index 100%
rename from examples/stm32/f1/stm32-maple/usb_cdcacm/README
rename to examples/stm32/f1/stm32-maple/usb_cdcacm/README.md
diff --git a/examples/stm32/f1/stm32vl-discovery/adc-dac-printf/README b/examples/stm32/f1/stm32vl-discovery/adc-dac-printf/README.md
similarity index 100%
rename from examples/stm32/f1/stm32vl-discovery/adc-dac-printf/README
rename to examples/stm32/f1/stm32vl-discovery/adc-dac-printf/README.md
diff --git a/examples/stm32/f1/stm32vl-discovery/button/README b/examples/stm32/f1/stm32vl-discovery/button/README.md
similarity index 100%
rename from examples/stm32/f1/stm32vl-discovery/button/README
rename to examples/stm32/f1/stm32vl-discovery/button/README.md
diff --git a/examples/stm32/f1/stm32vl-discovery/fancyblink/README b/examples/stm32/f1/stm32vl-discovery/fancyblink/README.md
similarity index 100%
rename from examples/stm32/f1/stm32vl-discovery/fancyblink/README
rename to examples/stm32/f1/stm32vl-discovery/fancyblink/README.md
diff --git a/examples/stm32/f1/stm32vl-discovery/miniblink/README b/examples/stm32/f1/stm32vl-discovery/miniblink/README.md
similarity index 100%
rename from examples/stm32/f1/stm32vl-discovery/miniblink/README
rename to examples/stm32/f1/stm32vl-discovery/miniblink/README.md
diff --git a/examples/stm32/f1/stm32vl-discovery/rtc/README b/examples/stm32/f1/stm32vl-discovery/rtc/README.md
similarity index 100%
rename from examples/stm32/f1/stm32vl-discovery/rtc/README
rename to examples/stm32/f1/stm32vl-discovery/rtc/README.md
diff --git a/examples/stm32/f1/stm32vl-discovery/spi/README b/examples/stm32/f1/stm32vl-discovery/spi/README.md
similarity index 100%
rename from examples/stm32/f1/stm32vl-discovery/spi/README
rename to examples/stm32/f1/stm32vl-discovery/spi/README.md
diff --git a/examples/stm32/f1/stm32vl-discovery/usart/README b/examples/stm32/f1/stm32vl-discovery/usart/README.md
similarity index 100%
rename from examples/stm32/f1/stm32vl-discovery/usart/README
rename to examples/stm32/f1/stm32vl-discovery/usart/README.md
diff --git a/examples/stm32/f1/waveshare-open103r/button/README b/examples/stm32/f1/waveshare-open103r/button/README.md
similarity index 100%
rename from examples/stm32/f1/waveshare-open103r/button/README
rename to examples/stm32/f1/waveshare-open103r/button/README.md
diff --git a/examples/stm32/f1/waveshare-open103r/fancyblink/README b/examples/stm32/f1/waveshare-open103r/fancyblink/README.md
similarity index 100%
rename from examples/stm32/f1/waveshare-open103r/fancyblink/README
rename to examples/stm32/f1/waveshare-open103r/fancyblink/README.md
diff --git a/examples/stm32/f1/waveshare-open103r/joystick/README b/examples/stm32/f1/waveshare-open103r/joystick/README.md
similarity index 100%
rename from examples/stm32/f1/waveshare-open103r/joystick/README
rename to examples/stm32/f1/waveshare-open103r/joystick/README.md
diff --git a/examples/stm32/f1/waveshare-open103r/miniblink/README b/examples/stm32/f1/waveshare-open103r/miniblink/README.md
similarity index 100%
rename from examples/stm32/f1/waveshare-open103r/miniblink/README
rename to examples/stm32/f1/waveshare-open103r/miniblink/README.md
diff --git a/examples/stm32/f1/waveshare-open103r/usbserial/README b/examples/stm32/f1/waveshare-open103r/usbserial/README.md
similarity index 100%
rename from examples/stm32/f1/waveshare-open103r/usbserial/README
rename to examples/stm32/f1/waveshare-open103r/usbserial/README.md
diff --git a/examples/stm32/f2/jobygps/miniblink/README b/examples/stm32/f2/jobygps/miniblink/README.md
similarity index 100%
rename from examples/stm32/f2/jobygps/miniblink/README
rename to examples/stm32/f2/jobygps/miniblink/README.md
diff --git a/examples/stm32/f3/stm32f3-discovery/adc/README b/examples/stm32/f3/stm32f3-discovery/adc/README.md
similarity index 100%
rename from examples/stm32/f3/stm32f3-discovery/adc/README
rename to examples/stm32/f3/stm32f3-discovery/adc/README.md
diff --git a/examples/stm32/f3/stm32f3-discovery/button/README b/examples/stm32/f3/stm32f3-discovery/button/README.md
similarity index 100%
rename from examples/stm32/f3/stm32f3-discovery/button/README
rename to examples/stm32/f3/stm32f3-discovery/button/README.md
diff --git a/examples/stm32/f3/stm32f3-discovery/fancyblink/README b/examples/stm32/f3/stm32f3-discovery/fancyblink/README.md
similarity index 100%
rename from examples/stm32/f3/stm32f3-discovery/fancyblink/README
rename to examples/stm32/f3/stm32f3-discovery/fancyblink/README.md
diff --git a/examples/stm32/f3/stm32f3-discovery/i2c/README b/examples/stm32/f3/stm32f3-discovery/i2c/README.md
similarity index 100%
rename from examples/stm32/f3/stm32f3-discovery/i2c/README
rename to examples/stm32/f3/stm32f3-discovery/i2c/README.md
diff --git a/examples/stm32/f3/stm32f3-discovery/miniblink/README b/examples/stm32/f3/stm32f3-discovery/miniblink/README.md
similarity index 100%
rename from examples/stm32/f3/stm32f3-discovery/miniblink/README
rename to examples/stm32/f3/stm32f3-discovery/miniblink/README.md
diff --git a/examples/stm32/f3/stm32f3-discovery/spi/README b/examples/stm32/f3/stm32f3-discovery/spi/README.md
similarity index 100%
rename from examples/stm32/f3/stm32f3-discovery/spi/README
rename to examples/stm32/f3/stm32f3-discovery/spi/README.md
diff --git a/examples/stm32/f3/stm32f3-discovery/usb_cdcacm/README b/examples/stm32/f3/stm32f3-discovery/usb_cdcacm/README.md
similarity index 100%
rename from examples/stm32/f3/stm32f3-discovery/usb_cdcacm/README
rename to examples/stm32/f3/stm32f3-discovery/usb_cdcacm/README.md
diff --git a/examples/stm32/f4/other/crypto-basic/README b/examples/stm32/f4/other/crypto-basic/README.md
similarity index 100%
rename from examples/stm32/f4/other/crypto-basic/README
rename to examples/stm32/f4/other/crypto-basic/README.md
diff --git a/examples/stm32/f4/stm32f4-discovery/README b/examples/stm32/f4/stm32f4-discovery/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f4-discovery/README
rename to examples/stm32/f4/stm32f4-discovery/README.md
diff --git a/examples/stm32/f4/stm32f4-discovery/adc-dac-printf/README b/examples/stm32/f4/stm32f4-discovery/adc-dac-printf/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f4-discovery/adc-dac-printf/README
rename to examples/stm32/f4/stm32f4-discovery/adc-dac-printf/README.md
diff --git a/examples/stm32/f4/stm32f4-discovery/button/README b/examples/stm32/f4/stm32f4-discovery/button/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f4-discovery/button/README
rename to examples/stm32/f4/stm32f4-discovery/button/README.md
diff --git a/examples/stm32/f4/stm32f4-discovery/dac-dma/README b/examples/stm32/f4/stm32f4-discovery/dac-dma/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f4-discovery/dac-dma/README
rename to examples/stm32/f4/stm32f4-discovery/dac-dma/README.md
diff --git a/examples/stm32/f4/stm32f4-discovery/fancyblink/README b/examples/stm32/f4/stm32f4-discovery/fancyblink/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f4-discovery/fancyblink/README
rename to examples/stm32/f4/stm32f4-discovery/fancyblink/README.md
diff --git a/examples/stm32/f4/stm32f4-discovery/mandelbrot/README b/examples/stm32/f4/stm32f4-discovery/mandelbrot/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f4-discovery/mandelbrot/README
rename to examples/stm32/f4/stm32f4-discovery/mandelbrot/README.md
diff --git a/examples/stm32/f4/stm32f4-discovery/miniblink/README b/examples/stm32/f4/stm32f4-discovery/miniblink/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f4-discovery/miniblink/README
rename to examples/stm32/f4/stm32f4-discovery/miniblink/README.md
diff --git a/examples/stm32/f4/stm32f4-discovery/random/README b/examples/stm32/f4/stm32f4-discovery/random/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f4-discovery/random/README
rename to examples/stm32/f4/stm32f4-discovery/random/README.md
diff --git a/examples/stm32/f4/stm32f4-discovery/tick_blink/README b/examples/stm32/f4/stm32f4-discovery/tick_blink/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f4-discovery/tick_blink/README
rename to examples/stm32/f4/stm32f4-discovery/tick_blink/README.md
diff --git a/examples/stm32/f4/stm32f4-discovery/usart/README b/examples/stm32/f4/stm32f4-discovery/usart/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f4-discovery/usart/README
rename to examples/stm32/f4/stm32f4-discovery/usart/README.md
diff --git a/examples/stm32/f4/stm32f4-discovery/usart_irq/README b/examples/stm32/f4/stm32f4-discovery/usart_irq/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f4-discovery/usart_irq/README
rename to examples/stm32/f4/stm32f4-discovery/usart_irq/README.md
diff --git a/examples/stm32/f4/stm32f4-discovery/usb_cdcacm/README b/examples/stm32/f4/stm32f4-discovery/usb_cdcacm/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f4-discovery/usb_cdcacm/README
rename to examples/stm32/f4/stm32f4-discovery/usb_cdcacm/README.md
diff --git a/examples/stm32/f4/stm32f4-discovery/usb_midi/README b/examples/stm32/f4/stm32f4-discovery/usb_midi/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f4-discovery/usb_midi/README
rename to examples/stm32/f4/stm32f4-discovery/usb_midi/README.md
diff --git a/examples/stm32/f4/stm32f4-discovery/usb_msc/README b/examples/stm32/f4/stm32f4-discovery/usb_msc/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f4-discovery/usb_msc/README
rename to examples/stm32/f4/stm32f4-discovery/usb_msc/README.md
diff --git a/examples/stm32/f4/stm32f429i-discovery/README b/examples/stm32/f4/stm32f429i-discovery/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f429i-discovery/README
rename to examples/stm32/f4/stm32f429i-discovery/README.md
diff --git a/examples/stm32/f4/stm32f429i-discovery/adc-dac-printf/README b/examples/stm32/f4/stm32f429i-discovery/adc-dac-printf/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f429i-discovery/adc-dac-printf/README
rename to examples/stm32/f4/stm32f429i-discovery/adc-dac-printf/README.md
diff --git a/examples/stm32/f4/stm32f429i-discovery/button/README b/examples/stm32/f4/stm32f429i-discovery/button/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f429i-discovery/button/README
rename to examples/stm32/f4/stm32f429i-discovery/button/README.md
diff --git a/examples/stm32/f4/stm32f429i-discovery/dac-dma/README b/examples/stm32/f4/stm32f429i-discovery/dac-dma/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f429i-discovery/dac-dma/README
rename to examples/stm32/f4/stm32f429i-discovery/dac-dma/README.md
diff --git a/examples/stm32/f4/stm32f429i-discovery/fancyblink/README b/examples/stm32/f4/stm32f429i-discovery/fancyblink/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f429i-discovery/fancyblink/README
rename to examples/stm32/f4/stm32f429i-discovery/fancyblink/README.md
diff --git a/examples/stm32/f4/stm32f429i-discovery/mandelbrot/README b/examples/stm32/f4/stm32f429i-discovery/mandelbrot/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f429i-discovery/mandelbrot/README
rename to examples/stm32/f4/stm32f429i-discovery/mandelbrot/README.md
diff --git a/examples/stm32/f4/stm32f429i-discovery/miniblink/README b/examples/stm32/f4/stm32f429i-discovery/miniblink/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f429i-discovery/miniblink/README
rename to examples/stm32/f4/stm32f429i-discovery/miniblink/README.md
diff --git a/examples/stm32/f4/stm32f429i-discovery/random/README b/examples/stm32/f4/stm32f429i-discovery/random/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f429i-discovery/random/README
rename to examples/stm32/f4/stm32f429i-discovery/random/README.md
diff --git a/examples/stm32/f4/stm32f429i-discovery/tick_blink/README b/examples/stm32/f4/stm32f429i-discovery/tick_blink/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f429i-discovery/tick_blink/README
rename to examples/stm32/f4/stm32f429i-discovery/tick_blink/README.md
diff --git a/examples/stm32/f4/stm32f429i-discovery/usart/README b/examples/stm32/f4/stm32f429i-discovery/usart/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f429i-discovery/usart/README
rename to examples/stm32/f4/stm32f429i-discovery/usart/README.md
diff --git a/examples/stm32/f4/stm32f429i-discovery/usart_irq/README b/examples/stm32/f4/stm32f429i-discovery/usart_irq/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f429i-discovery/usart_irq/README
rename to examples/stm32/f4/stm32f429i-discovery/usart_irq/README.md
diff --git a/examples/stm32/f4/stm32f429i-discovery/usb_cdcacm/README b/examples/stm32/f4/stm32f429i-discovery/usb_cdcacm/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f429i-discovery/usb_cdcacm/README
rename to examples/stm32/f4/stm32f429i-discovery/usb_cdcacm/README.md
diff --git a/examples/stm32/f4/stm32f429i-discovery/usb_midi/README b/examples/stm32/f4/stm32f429i-discovery/usb_midi/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f429i-discovery/usb_midi/README
rename to examples/stm32/f4/stm32f429i-discovery/usb_midi/README.md
diff --git a/examples/stm32/f4/stm32f429i-discovery/usb_msc/README b/examples/stm32/f4/stm32f429i-discovery/usb_msc/README.md
similarity index 100%
rename from examples/stm32/f4/stm32f429i-discovery/usb_msc/README
rename to examples/stm32/f4/stm32f429i-discovery/usb_msc/README.md
diff --git a/examples/stm32/l0/stm32l0538-disco/miniblink/README b/examples/stm32/l0/stm32l0538-disco/miniblink/README.md
similarity index 100%
rename from examples/stm32/l0/stm32l0538-disco/miniblink/README
rename to examples/stm32/l0/stm32l0538-disco/miniblink/README.md
diff --git a/examples/stm32/l1/stm32l-discovery/button-irq-printf-lowpower/README b/examples/stm32/l1/stm32l-discovery/button-irq-printf-lowpower/README.md
similarity index 100%
rename from examples/stm32/l1/stm32l-discovery/button-irq-printf-lowpower/README
rename to examples/stm32/l1/stm32l-discovery/button-irq-printf-lowpower/README.md
diff --git a/examples/stm32/l1/stm32l-discovery/button-irq-printf/README b/examples/stm32/l1/stm32l-discovery/button-irq-printf/README.md
similarity index 100%
rename from examples/stm32/l1/stm32l-discovery/button-irq-printf/README
rename to examples/stm32/l1/stm32l-discovery/button-irq-printf/README.md
diff --git a/examples/stm32/l1/stm32l-discovery/lcd-display/README b/examples/stm32/l1/stm32l-discovery/lcd-display/README.md
similarity index 100%
rename from examples/stm32/l1/stm32l-discovery/lcd-display/README
rename to examples/stm32/l1/stm32l-discovery/lcd-display/README.md
diff --git a/examples/stm32/l1/stm32l-discovery/miniblink/README b/examples/stm32/l1/stm32l-discovery/miniblink/README.md
similarity index 100%
rename from examples/stm32/l1/stm32l-discovery/miniblink/README
rename to examples/stm32/l1/stm32l-discovery/miniblink/README.md
diff --git a/examples/stm32/l1/stm32l-discovery/usart-semihosting/README b/examples/stm32/l1/stm32l-discovery/usart-semihosting/README.md
similarity index 100%
rename from examples/stm32/l1/stm32l-discovery/usart-semihosting/README
rename to examples/stm32/l1/stm32l-discovery/usart-semihosting/README.md
diff --git a/examples/stm32/l1/stm32l-discovery/usart/README b/examples/stm32/l1/stm32l-discovery/usart/README.md
similarity index 100%
rename from examples/stm32/l1/stm32l-discovery/usart/README
rename to examples/stm32/l1/stm32l-discovery/usart/README.md
diff --git a/examples/tiva/lm3s/lm3s3748-evb/miniblink/README b/examples/tiva/lm3s/lm3s3748-evb/miniblink/README.md
similarity index 100%
rename from examples/tiva/lm3s/lm3s3748-evb/miniblink/README
rename to examples/tiva/lm3s/lm3s3748-evb/miniblink/README.md
diff --git a/examples/tiva/lm3s/lm3s811-evb/miniblink/README b/examples/tiva/lm3s/lm3s811-evb/miniblink/README.md
similarity index 100%
rename from examples/tiva/lm3s/lm3s811-evb/miniblink/README
rename to examples/tiva/lm3s/lm3s811-evb/miniblink/README.md
diff --git a/examples/tiva/lm4f/stellaris-ek-lm4f120xl/miniblink/README b/examples/tiva/lm4f/stellaris-ek-lm4f120xl/miniblink/README.md
similarity index 100%
rename from examples/tiva/lm4f/stellaris-ek-lm4f120xl/miniblink/README
rename to examples/tiva/lm4f/stellaris-ek-lm4f120xl/miniblink/README.md
diff --git a/examples/tiva/lm4f/stellaris-ek-lm4f120xl/uart_echo_interrupt/README b/examples/tiva/lm4f/stellaris-ek-lm4f120xl/uart_echo_interrupt/README.md
similarity index 100%
rename from examples/tiva/lm4f/stellaris-ek-lm4f120xl/uart_echo_interrupt/README
rename to examples/tiva/lm4f/stellaris-ek-lm4f120xl/uart_echo_interrupt/README.md
diff --git a/examples/tiva/lm4f/stellaris-ek-lm4f120xl/uart_echo_simple/README b/examples/tiva/lm4f/stellaris-ek-lm4f120xl/uart_echo_simple/README.md
similarity index 100%
rename from examples/tiva/lm4f/stellaris-ek-lm4f120xl/uart_echo_simple/README
rename to examples/tiva/lm4f/stellaris-ek-lm4f120xl/uart_echo_simple/README.md
diff --git a/examples/tiva/lm4f/stellaris-ek-lm4f120xl/usb_to_serial_cdcacm/README b/examples/tiva/lm4f/stellaris-ek-lm4f120xl/usb_to_serial_cdcacm/README.md
similarity index 100%
rename from examples/tiva/lm4f/stellaris-ek-lm4f120xl/usb_to_serial_cdcacm/README
rename to examples/tiva/lm4f/stellaris-ek-lm4f120xl/usb_to_serial_cdcacm/README.md