大家好!
欢迎来到我们的社区!为了让大家能够更方便、更美观地分享想法和交流,我们的论坛支持使用 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): 使用
*
、+
或-
开头,再加上一个空格。 <br> Markdown* 列表项一 * 列表项二 * 嵌套列表项二点一 * 列表项三 - 列表项A - 列表项B
显示效果:
- 列表项一
- 列表项二
- 嵌套列表项二点一
- 列表项三
- 列表项A
- 列表项B
-
有序列表 (Ordered Lists): 使用数字加一个英文句点
.
再加一个空格。 <br> Markdown1. 第一项 2. 第二项 1. 嵌套第二项的第一点 3. 第三项
显示效果:
- 第一项
- 第二项
- 嵌套第二项的第一点
- 第三项
链接
想在帖子中添加网址链接?
Markdown
[链接显示的文字](链接地址)
[访问我们的论坛](https://hivelumi.com)
https://www.google.com
显示效果:
图片
想在帖子中插入图片?和链接的写法类似,只是在前面加一个感叹号 !
。
Markdown


显示效果:
(提示:请确保图片链接是有效的,并且可以在公网访问。)
代码
如果你是程序员,或者想分享一段代码,Markdown 也为你准备好了。
-
行内代码 (Inline Code): 用反引号 ``` 包裹单个词或短语。 <br> Markdown
在 JavaScript 中,`console.log()` 用来打印信息。
显示效果: <br> 在 JavaScript 中,
console.log()
用来打印信息。 -
代码块 (Code Blocks): 用三个反引号 `` 包裹多行代码。你还可以在第一组反引号后面指定语言类型,实现语法高亮。 <br> Markdown
```javascript function greet(name) { console.log(&amp;quot;Hello, &amp;quot; + name + &amp;quot;!&amp;quot;); } greet(&amp;quot;World&amp;quot;);
def hello(name): print(f&amp;quot;Hello, {name}!&amp;quot;) hello(&amp;quot;Markdown User&amp;quot;)
**显示效果:**
<br> JavaScript
```javascript
function greet(name) {
console.log(&amp;quot;Hello, &amp;quot; + name + &amp;quot;!&amp;quot;);
}
greet(&amp;quot;World&amp;quot;);
```
Python
```python
def hello(name):
print(f&amp;quot;Hello, {name}!&amp;quot;)
hello(&amp;quot;Markdown User&amp;quot;)
```
引用 (Blockquotes)
想引用别人的话?在文字前面加上 &amp;gt;
符号。
Markdown
&amp;gt; 这是一段引用的文字。
&amp;gt;
&amp;gt; &amp;gt; 嵌套引用也是可以的。
&amp;gt;
&amp;gt; —— 鲁迅 (乱编的)
显示效果:
&gt; 这是一段引用的文字。 > &gt; &gt; 嵌套引用也是可以的。 > &gt; —— 鲁迅 (乱编的)
分隔线 (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编辑器:
- Typora:极致简洁的“所见即所得”编辑器 Typora 是一款追求极致简洁的 Markdown 编辑器。它最大的特点是所见即所得,这意味着你输入的 Markdown 语法会立刻渲染成最终样式,你不再需要在左边是代码、右边是预览的两个窗口之间来回切换,让你能更专注于内容本身。
- 推荐理由:
- 实时预览: 提供无缝的实时预览体验,就像在写一篇格式优美的文章。
- 界面极简: 界面干净、无干扰,所有非必要元素都被隐藏起来,带来沉浸式的写作体验。
- 功能强大: 支持图表、公式、目录、文件管理等,对普通用户和高级用户都非常友好。
- 跨平台: 支持 Windows, macOS 和 Linux。
- 总结: 如果你追求写作的优雅和专注,希望有一个美观、简洁且强大的专用写作工具,Typora 是不二之选。
- VS Code:开发者必备的万能编辑器 Visual Studio Code (简称 VS Code) 是一款由微软开发的免费、开源且功能极其强大的代码编辑器。虽然它是一个代码编辑器,但通过其强大的插件生态系统,它也成为了一个顶级的 Markdown 编辑器。
- 推荐理由:
- 功能全面: 除了标准的 Markdown 预览功能(分屏预览),你可以安装 "Markdown All in One" 等插件来获得快捷键、自动生成目录、自动补全等强大功能。
- 高度可定制: 你可以根据自己的喜好配置无数的插件和主题,打造完全个性化的编辑环境。
- 代码友好: 如果你本身就是一位开发者,可以在同一个软件里无缝切换代码编写和文档写作,体验极佳。
- 完全免费: VS Code 是完全免费的,并且拥有活跃的社区和频繁的更新。
- 总结: 如果你是一位开发者,或者你喜欢折腾、需要一个高度可定制化且功能全面的免费工具,那么 VS Code 将是你的最佳伴侣。
以上就是Markdown的一些常用语法,是不是很简单?
现在就尝试用 Markdown 来书写你的第一篇帖子吧!如果你在使用的过程中遇到任何问题,欢迎随时向我提问。
祝大家在论坛交流愉快!
评论区
请登录后发表评论