Authoring Markdown

Our sites support writing content in Markdown, with some additions from GitHub Flavored Markdown as well as other custom syntaxes.

This page outlines the Markdown syntax we support as well as our style guidelines for authoring Markdown.

Prefer using Markdown syntax over custom HTML and components. Raw Markdown is easier to maintain, easier for tools to understand, and easier to migrate in the future if necessary.

Don't use Markdown's indented code blocks, only use fenced code blocks using backticks and always specify a language. For example:

```dart
void main() {
  print('Hello world!');
}
```

To learn more about customizing code blocks, check out the dedicated documentation on Code blocks.