Markdown is a lightweight markup language that allows you to format text with simple syntax. It's widely used for writing documentation, creating README files, and formatting code snippets. Here's a quick guide to get started:
Basic Syntax
- Headings: Use
#
for main headings,##
for subheadings, etc.
📖 Example:# Title
,## Subtitle
- Bold & Italics:
Bold text:**bold**
Italic text:*italic*
- Lists:
- Unordered list:
- item
- Ordered list:
1. item
- Unordered list:
- Links: Use
[text](url)
🌐 Example:[Visit our docs](/en/community/docs/how-to-write-docs)
- Code Blocks: Enclose code with triple backticks
🧾 Example:print("Hello, world!")
Advanced Features
- Tables:
Header 1 Header 2 Data 1 Data 2 - Images:
📷 Insert images using
. Example:
- Inline Code: Use backticks for single lines
This is an
inline codeexample.
Tips & Tricks
- Use
>
for blockquotes
📢 Example:> This is a blockquote.
- Escape special characters with backslashes
This is a \*asterisk\*.
For more detailed information, check out our documentation on writing guides. 📚