Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.
All products
Get started

This version of GitHub Enterprise was discontinued on 2023-03-15. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

About writing and formatting on GitHub

In this article

GitHub combines a syntax for formatting text called GitHub Flavored Markdown with a few unique writing features.

Markdown is an easy-to-read, easy-to-write syntax for formatting plain text.

We've added some custom functionality to create GitHub Flavored Markdown, used to format prose and code across our site.

You can also interact with other users in pull requests and issues using features like @-mentions, issue and PR references, and emoji. For more information, see "Basic writing and formatting syntax."

Text formatting toolbar

Every comment field on GitHub Enterprise Server contains a text formatting toolbar, which allows you to format your text without learning Markdown syntax. In addition to Markdown formatting like bold and italic styles and creating headers, links, and lists, the toolbar includes GitHub Enterprise Server-specific features such as @-mentions, task lists, and links to issues and pull requests.

Enabling fixed-width fonts in the editor

You can enable a fixed-width font in every comment field on GitHub Enterprise Server. Each character in a fixed-width, or monospace, font occupies the same horizontal space. This can make it easier to edit advanced Markdown structures such as tables and code snippets.

Screenshot of a GitHub comment showing a sample Markdown table listing two Git commands. All letters in the table are the same visual width.

  1. In the upper-right corner of any page, click your profile photo, then click Settings.

    Screenshot of GitHub's account menu showing options for users to view and edit their profile, content, and settings. The menu item "Settings" is outlined in dark orange.

  2. In the user settings sidebar, click Appearance.

  3. Under "Markdown editor font preference", select Use a fixed-width (monospace) font when editing Markdown. Screenshot of GitHub user settings for Markdown preference. The checkbox to use a fix-width font in Markdown is checked and outlined in dark orange.

Further reading