This lesson is still being designed and assembled (Pre-Alpha version)

Creating a Markdown Document in HedgeDoc

Overview

Teaching: 0 min
Exercises: 0 min
Questions
  • How do I create a new Markdown document?

Objectives
  • Create a new document on HedgeDoc

HedgeDoc

For this lesson we will use an online and open source tool called HedgeDoc to learn Markdown. There is no software to install on your local computer, but you will need an active internet connection and a modern web browser, Chrome, Firefox, Safari or MS Edge during the lesson. HedgeDoc will allow you to type Markdown text and see how it will be rendered all in one screen.

Make your first HedgeDoc Page

You can create a demo HedgeDoc document on the HedgeDoc project’s server by clicking this link:

Make a Document (Try to open this link in a new tab)

This will create a new (unique to you) document that you can use to learn about Markdown with.

This is not a private document and you should not have any expectation that text you place in this tool will be kept or private. We are using it as a learning tool to learn about Markdown syntax, and you should not store any personal or private information in this document.

Find your document again

Note: Should you lose track of the page you were typing in, you can find it again by clicking History at the top of the main HedgeDoc demo server page.

HedgeDoc User Interface

HedgeDoc main screen:

HedgeDoc Interface

The main HedgeDoc Screen contains an editing panel (on the left) and a preview panel (on the right) you can enter Markdown syntax on the left and see it rendered on the right.

HedgeDoc views:

HedgeDoc views

If you’d prefer a bigger preview area, you can click the leftmost eye icon, if you’d like a split-view (as in the screenshot above) you can click the middle two-panel icon, if you’d like a bigger editing area you can click the rightmost pencil icon. By default your document will be in the split screen view, which is good while you’re learning Markdown.

HedgeDoc Menu:

HedgeDoc Menu

The menu across the top can be a useful crutch when you can’t remember specific Markdown syntax. Clicking on one of the icons will make an example of that kind of Markdown element appear in the editor. During the lesson try not to use this menu, but when you come back to writing Markdown after a break for awhile, it is a very useful helper.

Key Points

  • Create a new document on HedgeDoc