Update markdown.mdx based on issue #242

Author: kgowru

fern/products/docs/pages/writing-content/markdown.mdx

@@ -0,0 +1,40 @@
+# Images
+
+In Fern documentation, you can add images using standard Markdown syntax or HTML image tags. Images provide visual aids to help users better understand concepts, follow tutorials, or see examples of the interface.
+
+## Basic Image Syntax
+
+### Markdown
+```md
+![Alt text](./path/to/image.png)
+```
+
+### HTML
+```html
+<img src="./path/to/image.png" alt="Alt text" />
+```
+
+## Image Options
+
+### Disable Zoom
+To prevent an image from being zoomable when clicked, add the `noZoom` attribute:
+
+```html
+<img src="./path/to/image.png" alt="Alt text" noZoom />
+```
+
+### Dark Mode Support
+For images that need different versions in light and dark modes:
+
+```html
+<img src="./light-image.png" alt="Light mode image" className="dark:hidden" />
+<img src="./dark-image.png" alt="Dark mode image" className="hidden dark:block" />
+```
+
+## Best Practices
+
+- Use descriptive alt text for accessibility
+- Keep image file sizes optimized
+- Provide appropriate context around images
+- Use consistent image dimensions within a document
+- Consider dark mode compatibility when relevant