• FC/NES
  • SFC/SNES
  • N64
  • NGC
  • Wii
  • WiiU
  • GameBoy
  • GBC
  • GBA
  • NDS
  • 3DS
  • PS1
  • PS2
  • PS3
  • PSP
  • PSV
  • MD
  • SS
  • DC
  • PC-E
  • Xbox360
  • More...
 13 12
发新话题
打印

本论坛使用的MarkDown编辑器小教程

本主题由 Mr.C 于 2023-3-9 01:04 关闭

本论坛使用的MarkDown编辑器小教程

开始使用论坛时,应该细心的小伙伴们就发现了,我们虽然用的是Discuz老版本的论坛程序。

但是没有编辑器,那么,没有编辑器,就只能文字书写了吗?

其实不是的,我们是屏蔽了Discuz默认的BBcode,改用了Markdown书写格式

## 那么,什么是Markdown?

Markdown格式是John Gruber于2004年创造的, Markdown 的目标是实现“易读易写”。 Markdown定义了一种简单好用的文本文件格式, 作为单独的文本文件, 此格式没有什么多余的标签, 又可以转化为很多其它的格式。

Markdown 的语法全由一些符号所组成, 这些符号经过精挑细选,其作用一目了然。 比如:在文字两旁加上星号,看起来就像强调。 Markdown 的列表看起来就像我们平常在邮件中写一个列表的方法。 Markdown 的区块引用看起来就真的像是引用一段文字, 就像你曾在电子邮件中见过的那样。

需要时, 可以直接在markdown中写HTML标记内容。 markdown能实现的功能是HTML的一部分, 但是比HTML内容更干净, 没有掺杂过多的与要表达的意思无关的标签。 Markdown的理念是,能让文档更容易读、写和随意改。

**Markdown 语法的目标是:成为一种适用于网络的书写语言。**

Markdown 不是想要取代 HTML,甚至也没有要和它相近,它的语法种类很少,只对应 HTML 标记的一小部分。Markdown 的构想不是要使得 HTML 文档更容易书写。在我看来, HTML 已经很容易写了。

Markdown 的理念是,能让文档更容易读、写和随意改。HTML 是一种发布的格式,Markdown 是一种书写的格式。就这样,Markdown 的格式语法只涵盖纯文本可以涵盖的范围。

> 总结一下,那就是,即便不解析markdown格式了,所有的帖子依然具备相当强的阅读性。
>
>而Markdwon这个优点,是html标签,bbcode均不具备的。
>
>可能我这样说,没有什么说服力,来让我们看看图片
>
>![MarkDown代码](https://cdn.staticaly.com/gh/ijuse/mywebsiteimgs/main/202302/202303112351817.webp)
>
>所以,大家看完了这个,相信也知道MarkDown格式相对于以前的各种书写格式有着非常强的优势。
>
>这也是为啥我从建站开始就一直坚持使用Markdown的原因

好了废话不多说了,大家看教程吧。

段落(换行/回行问题)

>Markdown的书写格式,稍微区别于普通的文本格式,希望诸君能耐心看完这篇小教程 😃

普通的书写格式,一次回车换行即可。

例如
```
白日依山尽,黄河入海流。
欲穷千里目,更上一层楼。
```
但是markdown会显示为


白日依山尽,黄河入海流。
欲穷千里目,更上一层楼。

---------------------

如果想换行, 输入时要`回车两次`。例如:
```
白日依山尽,黄河入海流。

欲穷千里目,更上一层楼。
```
显示结果为:

白日依山尽,黄河入海流。

欲穷千里目,更上一层楼。

---------------

>这里举个小例子大家就明白为什么这样做了。

打个比方

以下是新闻稿件

>北京时间3月12日凌晨4点,22/23赛季法甲联赛第27轮继续。
>在弗朗西斯勒布雷球场,巴黎圣日耳曼客场2-1绝杀布雷斯特,多赛一场以11分的优势领跑。
>索莱尔首开纪录,霍诺拉特扳平比分,梅西助攻姆巴佩绝杀,并斩获俱乐部生涯第300次助攻。

这是编辑器中你书写的格式

![](https://cdn.staticaly.com/gh/ijuse/mywebsiteimgs/main/202302/202303121119071.webp)

这样一来,我们可以利用编辑器的单行回行,将一长段的文字拆分开编辑,并且保持发布后不改变这个长段,更利于写作。

------------

此外,对于目前大多数人的阅读习惯。

过长的文字已经不具备可读性了,所以大家灵活运用吧 😁

段内文字格式

## 加粗
格式为`**需要加粗的文字**`

显示为

**需要加粗的文字**
## 斜体字
格式为`*需要斜体的文字*`

显示为

*需要斜体的文字*

## 那斜体加粗呢?
格式为`***需要斜体加粗的文字***`

显示为

***需要斜体加粗的文字***

## 删除线
格式为`~~需要删除线的文字~~`

显示为

~~需要删除线的文字~~

## 分割线
格式为`----------------------`

显示为

这是分割线

-------------------------------

这是分割线

引用段落

可以用类似Email的回复包含原始邮件内容的办法输入引用段落, 即,在段落的每行前面加一个大于号。 比如下面的诗:
```
> 白日依山尽,黄河入海流。
> 欲穷千里目,更上一层楼。
```
转换成

> 白日依山尽,黄河入海流。
> 欲穷千里目,更上一层楼。

注意引用也是段落模式,内容中的换行不起作用,空行导致分段。

引用段落也可以仅在段落第一行写大于号, 其它行顶格写,例如下面的两段引用:

```
> 远上寒山石径斜,
白云生处有人家。
>
> 停车坐爱枫林晚,
霜叶红于二月花。
```
显示为

> 远上寒山石径斜,
白云生处有人家。
>
> 停车坐爱枫林晚,
霜叶红于二月花。

引用也可以嵌套,如:
```
> 张三说:李四这样说过
>
>> 不想当将军的木匠不是好厨子。
>
```
显示为

> 张三说:李四这样说过
>
>> 不想当将军的木匠不是好厨子。
>

文章内标题

示例:
```
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题
```
显示为

# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

贴内图片

贴内图片,其格式为
```
![图片描述](图片地址)
```
显示为
![论坛LOGO](/images/Overcast/logo.gif)

表格

在markdown里制作表格也非常简单,看下面的源码

```
表头|表头2|表头3
--|--|--
内容|内容2|内容3
内容|内容2|内容3
内容|内容2|内容3
内容|内容2|内容3
```
显示为

表头|表头2|表头3
--|--|--
内容|内容2|内容3
内容|内容2|内容3
内容|内容2|内容3
内容|内容2|内容3

## 表格内换行

可以用`<br>`表示换行。

举例
```
Name|Lucky Number
--|--
Leslie|2<br>7
Mike|3<br>5<br>8
```
显示为

Name|Lucky Number
--|--
Leslie|2<br>7
Mike|3<br>5<br>8

文章内代码

代码块是使用上下三个连续的“ **`** ”符号来表达

![文章内代码——代码块](https://cdn.staticaly.com/gh/ijuse/mywebsiteimgs/main/202303/202303081321633.png)

显示为
```
function getage(age){
    return age
}
```
## 文字内的代码呢?
```
文字内的代码是使用`这里是代码`来显示
```

显示为

文字内的代码是使用`这里是代码`来显示

有序列表,无序列表

## 有序列表
有序列表:使用数字进行标号

```
考试排名:
1. 小红
2. 小陈
3. 小李
```
显示为

考试排名:
1. 小红
2. 小陈
3. 小李

## 无序列表
使用符号+ - *任意一个都可以。

注意:不能混用。自动划分,不同符号创建的列表
```
+ 水果
+ 香蕉
+  桃子
+ 苹果
- 水果
- 香蕉
-  桃子
- 苹果
* 水果
* 香蕉
*  桃子
* 苹果
```
显示为

+ 水果
+ 香蕉
+  桃子
+ 苹果
- 水果
- 香蕉
-  桃子
- 苹果
* 水果
* 香蕉
*  桃子
* 苹果

超链接

行内式
格式为:
```
[链接文字](地址)
```
例如:
```
[百度首页](https://www.baidu.com/)
```
效果如下:

[百度首页](https://www.baidu.com/)

## 参考式
参考式超链接一般用在学术论文上,或者某个链接在文章中多处被引用的情况,这样便于对链接统一管理。

参考式链接的写法相当于把行内式拆分成两部分,并通过一个链接标记来连接两部分。

语法说明:

参考式链接分为两部分:首先写
```
[链接文字][链接标记]
```
然后在文本的任意位置写
```
[链接标记]:地址 "标题"
```
例如:
```
我经常去的几个网站是[GitHub][1],[知乎][2],[简书][3]。

[1]:https://github.com "github.com"
[2]:https://www.zhihu.com "zhihu.com"
[3]:http://www.jianshu.com "jianshu.com"
```

显示为

我经常去的几个网站是[GitHub][1],[知乎][2],[简书][3]。

[1]:https://github.com "github.com"
[2]:https://www.zhihu.com "zhihu.com"
[3]:http://www.jianshu.com "jianshu.com"

 13 12
发新话题
欢迎关注本
站公众号