Skip to main content

Markdown features

DocStatic uses Markdown as its main content authoring format. You can learn it in ten minutes. But you don't have to because the CMS provides a full rich text editing environment for metadata, Markdown and React components.

Simple Structured Authoring​

Topics in DocStatic have three parts:

  • Metadata (in YAML format)
  • Content (in Markdown)
  • Predefined React components.

The CMS makes sure metadata and Markdown are used consistently, while the React components provide a uniform style and support for content reuse features. You don’t need to add any JSX code yourself as the components are already available globally.

Standard features​

Markdown features include:

  • Bold, code, italic and strikethrough character styles.
  • Bulleted and numbered lists.
  • Code blocks.
  • Heading levels (1 to 6).
  • Horizontal rules.
  • Images.
  • Links.
  • Quotes.
  • Simple tables.

These can all be selected directly from the rich text toolbar in the CMS.

To these, Docusaurus adds:

  • Admonitions
  • Details (expanding content)
  • Doc card lists
  • Tabs

DocStatic further extends this with:

  • Code snippets (from files)
  • Comments
  • Conditional text
  • Context help links
  • Diagrams
  • Figures
  • Footnotes
  • Glossary terms
  • Math equations
  • Snippets
  • Variables

Front matter​

Front matter is used to add metadata to your Markdown file. It's provided at the very top of the file, enclosed by three dashes ---. Content plugins may have their own front matter schema. DocStatic uses the front matter for:

  • Conditions (for conditional text)
  • Descriptions
  • Slugs (fixed paths)
  • Taxonomy tags
  • Titles
  • Workflow status

Details​

  1. Select Details from the Embed list.
  2. Edit the component.
  3. Give it a Summary.
  4. Enter the Details.

Example:​

Toggle me.

This is the detailed content.

You can use Markdown here including bold and italic text, and inline links.

Doc card lists​

Doc card lists are automatically generated for categories in the table of contents. However, you can also manually add them to a topic.

  1. Select Doc Card List from the Embed list.
  2. Give it a Title.

For more information, refer to Markdown Features in the Docusarus documentation.

Example:​