diff --git a/src/plugins/kibana_react/public/index.ts b/src/plugins/kibana_react/public/index.ts
index 3311f42bff55d..0d01bd9e0dcd2 100644
--- a/src/plugins/kibana_react/public/index.ts
+++ b/src/plugins/kibana_react/public/index.ts
@@ -72,6 +72,7 @@ export { ValidatedDualRange } from './validated_range';
 export type { ToastInput, KibanaReactNotifications } from './notifications';
 export { createNotifications } from './notifications';
 
+/** @deprecated use `Markdown` from `@kbn/shared-ux-markdown` */
 export { Markdown, MarkdownSimple } from './markdown';
 
 export { reactToUiComponent, uiToReactComponent } from './adapters';
diff --git a/src/plugins/kibana_react/public/markdown/index.tsx b/src/plugins/kibana_react/public/markdown/index.tsx
index 99da8a3c8898c..d0c72d8db8d76 100644
--- a/src/plugins/kibana_react/public/markdown/index.tsx
+++ b/src/plugins/kibana_react/public/markdown/index.tsx
@@ -17,6 +17,7 @@ const Fallback = () => (
   </EuiDelayRender>
 );
 
+/** @deprecated use `Markdown` from `@kbn/shared-ux-markdown` */
 const LazyMarkdownSimple = React.lazy(() => import('./markdown_simple'));
 export const MarkdownSimple = (props: MarkdownSimpleProps) => (
   <React.Suspense fallback={<Fallback />}>
@@ -24,6 +25,7 @@ export const MarkdownSimple = (props: MarkdownSimpleProps) => (
   </React.Suspense>
 );
 
+/** @deprecated use `Markdown` from `@kbn/shared-ux-markdown` */
 const LazyMarkdown = React.lazy(() => import('./markdown'));
 export const Markdown = (props: MarkdownProps) => (
   <React.Suspense fallback={<Fallback />}>