Contributing
DocumentationGitHub
  • Contributing to Umbraco
  • Hacktoberfest 2024
    • Contributing to Hacktoberfest
  • Documentation
    • How to contribute
      • Submit a Pull Request
      • Submit Feedback
      • Create a new version of an article
    • Style Guide
      • Markdown Conventions
      • Code Blocks
      • Structure
    • UmbracoDocs on GitHub
  • Umbraco-CMS
    • How to contribute
      • Before you start
      • Finding your first issue: Up for grabs
      • Building the codebase
      • Unwanted changes
      • Other ways to contribute
    • Umbraco-CMS on GitHub
  • UI Library
    • How to contribute
    • Components
    • Umbraco.UI on GitHub
  • Backoffice Project
    • How to contribute
    • Umbraco.CMS.Backoffice on GitHub
Powered by GitBook
On this page
  • Links
  • External links
  • Internal links
  • Page Links
  • Formatting code
  • Inline code
  • Code Blocks
  • Adding tips and warnings

Was this helpful?

Export as PDF
  1. Documentation
  2. Style Guide

Markdown Conventions

Learn how to use Markdown to write articles for the Umbraco Documentation.

The Umbraco Documentation uses Markdown for all articles.

In this article you can learn how we Markdown for different elements on our documentation.

Links

In the following you will find a few examples of different links.

External links

Include either the complete URL, or link using the following syntax:

[yahoo something](https://yahoo.com/something)

Internal links

When linking between pages in the documentation, link using relative paths. The following are examples of linking to an article.

Link to an article in the same directory as the current article:

[Article Title](article.md)

Link to an article in a different directory than the current article:

[Article Title](../../reference/article.md)

Use the title of the article that is linked to, as the link text. This is done in order to tell the reader what the will find on the other end.

Do not use here or link as the link text, as this provides little to no information about the destination.

Page Links

It is possible to add a page link that spans the entire width of the page. This is generally used for linking to a new subject related to the article at hand.

The following is a page link that links to the "Submit Feedback" article:

{% content-ref url="issues.md" %}

[issues.md](issues.md)

{% endcontent-ref %}

Formatting code

Code formatting comes in 2 variants: inline code and code blocks.

Inline code

Use inline code when referencing file names and paths as well as actual code the does not extend over multiple lines.

Inline code should be wrapped in ` (backtick) characters.

Code Blocks

Adding tips and warnings

Four types of hints can be added to our documentation: info, success, warning and danger.

PreviousStyle GuideNextCode Blocks

Last updated 3 months ago

Was this helpful?

We follow to our articles.

.

Submit Feedback
GitBooks conventions for adding code blocks
Learn more about how to use hints in the GitBook Docs