Skip to main content

Test md

· 2 min read

Front Matter

Markdown documents have metadata at the top called Front Matter:

my-doc.md


## Markdown heading

Markdown text with [links](./hello.md)

Regular Markdown links are supported, using url paths or relative file paths.

Let's see how to [Create a page](/create-a-page).
Let's see how to [Create a page](./blog).

Result: Let's see how to Create a page.

Images

Regular Markdown images are supported.

You can use absolute paths to reference images in the static directory (static/img/banner-1500x500.png):

![my logo](../../static/img/banner-1500x500.png)

my logo

You can reference images relative to the current file as well. This is particularly useful to colocate images close to the Markdown files using them:

![my logo](./img/banner-1500x500.png)

Code Blocks

Markdown code blocks are supported with Syntax highlighting.

src/components/Hello.js
function Hello() {
return (
<h1>Hello!</h1>
)
}
src/components/Hello.js
function Hello() {
return <h1>Hello!</h1>;
}

Admonitions

My tip

Use this awesome feature option

Take care

This action is dangerous

My tip

Use this awesome feature option

Take care

This action is dangerous

MDX and React Components

MDX can make your documentation more interactive and allows using any React components inside Markdown:

export const Highlight = ({children, color}) => (
<span
style={{
backgroundColor: color,
borderRadius: '20px',
color: '#fff',
padding: '10px',
cursor: 'pointer',
}}
onClick={() => {
alert(`You clicked the color ${color} with label ${children}`)
}}>
{children}
</span>
);

This is <Highlight color="#25c2a0">green</Highlight> !

This is <Highlight color="#1877F2">blue</Highlight> !

This is green !

This is blue !

Last Updated: Jan 16th, 2024

No planned Changes