大家好!
欢迎来到我们的社区!为了让大家能够更方便、更美观地分享想法和交流,我们的论坛支持使用 Markdown 格式来书写帖子。
什么是Markdown?
Markdown是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写,Markdown被大量使用,如Github、Wikipedia、简书等。
千万不要被「标记」、「语言」吓到,Markdown的语法十分简单,常用的标记符号不超过十个,用于日常写作记录绰绰有余,不到半小时就能完全掌握。
就是这十个不到的标记符号,却能让人优雅地沉浸式记录,专注内容而不是纠结排版,达到「心中无尘,码字入神」的境界。
Markdown快速上手指南
标题
想让你的文章结构更清晰?用标题!在文字前面加上 #
号(#和文字之间要有一个空格),# 的数量代表标题的级别。
Markdown
# 这是一级标题 (H1)
## 这是二级标题 (H2)
### 这是三级标题 (H3)
#### 这是四级标题 (H4)
##### 这是五级标题 (H5)
###### 这是六级标题 (H6)
显示效果:
这是一级标题 (H1)
这是二级标题 (H2)
这是三级标题 (H3)
这是四级标题 (H4)
这是五级标题 (H5)
这是六级标题 (H6)
强调
想突出某些文字?很简单!
- 加粗 (Bold): 用两个
**
或__
包裹文字。 - 斜体 (Italic): 用一个
*
或_
包裹文字。 - 加粗并斜体 (Bold and Italic): 用三个
***
或___
包裹文字。
Markdown
**这是加粗的文字**
__这也是加粗的文字__
*这是倾斜的文字*
_这也是倾斜的文字_
***这是加粗并倾斜的文字***
___这也是加粗并倾斜的文字___
显示效果:
这是加粗的文字 这也是加粗的文字
这是倾斜的文字 这也是倾斜的文字
这是加粗并倾斜的文字 这也是加粗并倾斜的文字
列表
想列出几点内容?Markdown 支持有序列表和无序列表。
-
无序列表 (Unordered Lists): 使用
*
、+
或-
开头,再加上一个空格。Markdown
* 列表项一 * 列表项二 * 嵌套列表项二点一 * 列表项三 - 列表项A - 列表项B
显示效果:
-
列表项一
-
列表项二
- 嵌套列表项二点一
-
列表项三
-
列表项A
-
列表项B
-
-
有序列表 (Ordered Lists): 使用数字加一个英文句点
.
再加一个空格。Markdown
1. 第一项 2. 第二项 1. 嵌套第二项的第一点 3. 第三项
显示效果:
- 第一项
- 第二项
- 嵌套第二项的第一点
- 第三项
链接
想在帖子中添加网址链接?
Markdown
[链接显示的文字](链接地址)
[访问我们的论坛](https://hivelumi.com)
https://www.google.com
显示效果:
图片
想在帖子中插入图片?和链接的写法类似,只是在前面加一个感叹号 !
。
Markdown


显示效果:
(提示:请确保图片链接是有效的,并且可以在公网访问。)
代码
如果你是程序员,或者想分享一段代码,Markdown 也为你准备好了。
-
行内代码 (Inline Code): 用反引号 ``` 包裹单个词或短语。
Markdown
在 JavaScript 中,`console.log()` 用来打印信息。
显示效果:
在 JavaScript 中,
console.log()
用来打印信息。 -
代码块 (Code Blocks): 用三个反引号 `` 包裹多行代码。你还可以在第一组反引号后面指定语言类型,实现语法高亮。
Markdown
```javascript function greet(name) { console.log("Hello, " + name + "!"); } greet("World"); ``` ```python def hello(name): print(f"Hello, {name}!") hello("Markdown User") ```
显示效果:
JavaScript
function greet(name) { console.log("Hello, " + name + "!"); } greet("World");
Python
def hello(name): print(f"Hello, {name}!") hello("Markdown User")
引用 (Blockquotes)
想引用别人的话?在文字前面加上 >
符号。
Markdown
> 这是一段引用的文字。
>
> > 嵌套引用也是可以的。
>
> —— 鲁迅 (乱编的)
显示效果:
这是一段引用的文字。
嵌套引用也是可以的。
—— 鲁迅 (乱编的)
分隔线 (Horizontal Rules)
想在内容之间添加一条分隔线?使用三个或更多的 *
、-
或 _
。
Markdown
***
---
___
显示效果:
删除线 (Strikethrough)
想给文字加上删除效果?用两个波浪线 ~~
包裹文字。
Markdown
~~这段文字被删除了~~
显示效果:
~~这段文字被删除了~~
表格 (Tables)
创建表格稍微复杂一点,但依然很有用(写表格更好的是用markdown编辑器直接生成,这样更方便)。
Markdown
| 表头1 | 表头2 | 表头3 |
| :---- | :---: | ----: |
| 左对齐 | 居中对齐 | 右对齐 |
| 内容1 | 内容2 | 内容3 |
| 内容A | 内容B | 内容C |
显示效果:
| 表头1 | 表头2 | 表头3 | | ------ | -------- | ------ | | 左对齐 | 居中对齐 | 右对齐 | | 内容1 | 内容2 | 内容3 | | 内容A | 内容B | 内容C |
解释:
-
第一行是表头。
-
第二行
| :---- | :---: | ----: |
用来定义对齐方式:
:----
表示该列内容左对齐。:---:
表示该列内容居中对齐。----:
表示该列内容右对齐。
-
后面的每一行都是表格的内容。
-
每一列都用
|
分隔。
以上就是Markdown的一些常用语法,是不是很简单?
现在就尝试用 Markdown 来书写你的第一篇帖子吧!如果你在使用的过程中遇到任何问题,欢迎随时向我提问。
祝大家在论坛交流愉快!
评论区
请登录后发表评论