Markdown Tutorial
Markdown is a lightweight markup language that allows people to write documents using an easy-to-read and easy-to-write plain text format.
The Markdown language was created in 2004 by John Gruber.
Documents written in Markdown can be exported to various formats such as HTML, Word, images, PDF, Epub, and more.
Markdown documents have file extensions .md, .markdown.
Markdown Applications
Markdown can be used to write e-books, such as Gitbook.
Many websites currently use Markdown extensively to write help documents or to post messages on forums. Examples include GitHub, Jianshu, reddit, Diaspora, Stack Exchange, OpenStreetMap, SourceForge, and more.
Editor
This tutorial will use the VSCode editor to explain Markdown syntax. VSCode supports MacOS, Windows, and Linux platforms and includes various themes.
VSCode natively integrates a Markdown document editing plugin and supports syntax highlighting for Markdown.
VSCode (full name: Visual Studio Code) is a free, cross-platform source code editor developed by Microsoft.
- VSCode Installation Tutorial: https://www.tutorialpro.org/w3cnote/vscode-tutorial.html
- VSCode Official Website: https://code.visualstudio.com/
To enable real-time preview in VSCode, you need to execute the Markdown: Open Preview to the Side command.
Enter the Markdown: Open Preview to the Side command in the command window:
The final effect:
If you need to convert Markdown to formats like PDF, images, or HTML, you can also install the corresponding plugins.
You can also use our online editor to test: https://c.tutorialpro.org/front-end/712.
Test Example
In the following test, we will first install the Markdown Preview Enhanced plugin in VSCode to achieve more powerful features.
Click the extension button on the right sidebar, search for the Markdown Preview Enhanced plugin, and click install:
Restart VSCode after installation.
Enter the following code in tutorialpro.md:
# tutorialpro Markdown Test
## Hello World!
Paste this code into the tutorialpro.md file, and the effect will be as follows:
Right-clicking the mouse in the preview box also provides various export functions:
Useful Books
Great Markdown: