Markdown Syntax

Write rich documentation with standard Markdown and MDC-friendly content patterns.

Docd uses Nuxt Content with MDC, so standard Markdown works as expected and can be mixed with components when needed.

Titles

Use headings to create structure and build the table of contents automatically.

Subtitles

Subheadings make long pages easier to scan.

Each heading creates an anchor link and can appear in the page ToC.

Text formatting

Docd supports standard inline Markdown formatting.

StyleHow to useResult
Bold**bold**Bold
Italic*italic*Italic
Strike~~strike~~Strike

You can also combine styles when you need stronger emphasis.

StyleHow to useResult
Bold italic**_bold italic_**Bold italic
Bold strike~~**bold**~~Bold
Italic strike~~*italic*~~Italic

Links

Use normal Markdown links for external references and internal docs navigation.

Internal links

For internal docs pages, use root-relative paths based on the final route.

Lists

Markdown supports unordered, ordered, and nested lists.

Unordered

  • Write content in Markdown.
  • Use MDC components when needed.
  • Let Docd render navigation automatically.

Ordered

  1. Create a page in content/.
  2. Add frontmatter.
  3. Start writing.

Nested

  • Content
    • Markdown pages
    • Navigation metadata
  • App
    • Layout overrides
    • Custom components

Tables

Tables are useful for props, configuration fields, and comparisons.

PropDefaultType
hideTocfalseboolean
links[]array
publishedAtoptionalstring

Blockquotes

Use blockquotes for references, callouts, or quoted guidance.

Single line

Docd keeps content in Markdown and leaves application logic in Nuxt.

Multiple paragraphs

Docd is a reusable Nuxt layer for documentation sites.

It combines Nuxt Content, MDC, UI Thing, and Tailwind CSS v4 into one docs-focused stack.

Nuxt

Use Docd as a normal Nuxt application with layouts, components, modules, and server logic.

Code Blocks

Display inline code, filenames, grouped snippets, and file trees in Docd.