Merge pull request #9557 from marmelab/expand-markdown-field-doc

Doc: Improve MarkdownField doc

docs/MarkdownField.md

@@ -7,6 +7,8 @@ title: "The MarkdownField Component"
 
 This [Enterprise Edition](https://marmelab.com/ra-enterprise)<img class="icon" src="./img/premium.svg" /> component allows to render Markdown data as HTML.
 
+![MarkdownField preview](https://marmelab.com/ra-enterprise/modules/assets/ra-markdown/latest/markdown-field-preview.png)
+
 ```jsx
 import { Show, SimpleShowLayout, TextField } from 'react-admin';
 import { MarkdownField } from '@react-admin/ra-markdown';
@@ -21,4 +23,19 @@ const PostShow = () => (
 );
 ```
 
+**Tip**: If you want to display raw (unformatted) markdown, use `<TextField component="pre">` instead:
+
+```tsx
+import { Show, SimpleShowLayout, TextField } from 'react-admin';
+
+const PostShow = () => (
+    <Show>
+        <SimpleShowLayout>
+            <TextField source="title" />
+            <TextField source="description" component="pre" />
+        </SimpleShowLayout>
+    </Show>
+);
+```
+
 Check [the `ra-markdown` documentation](https://marmelab.com/ra-enterprise/modules/ra-markdown) for more details.