



本论坛使用的MarkDown编辑器小教程
开始使用论坛时,应该细心的小伙伴们就发现了,我们虽然用的是Discuz老版本的论坛程序。但是编辑器却没有任何按钮,并且也不支持常见的bbcode
<div class="i">其原因是因为老Discuz论坛虽然速度飞快,但是它的核心bbcode在某种意义上来说已经落后于时代了,并且在解析和发帖时都会有很多小毛病,而这些小毛病对于我这种程序小白来说是很难修复的。
而Markdown格式的出现就解决了这一问题,并且对于markdown来说我们有好几套应对的解析方式,并且这些解析markdown格式的js都是开源的,一个不行了换另一个照样也可以,并且不影响咱们的发帖格式。</div>
所以我们是屏蔽了Discuz默认的BBcode,改用了Markdown书写格式
## 那么,什么是Markdown?
Markdown格式是John Gruber于2004年创造的, Markdown 的目标是实现“易读易写”。 Markdown定义了一种简单好用的文本文件格式, 作为单独的文本文件, 此格式没有什么多余的标签, 又可以转化为很多其它的格式。
Markdown 的语法全由一些符号所组成, 这些符号经过精挑细选,其作用一目了然。 比如:在文字两旁加上星号,看起来就像强调。 Markdown 的列表看起来就像我们平常在邮件中写一个列表的方法。 Markdown 的区块引用看起来就真的像是引用一段文字, 就像你曾在电子邮件中见过的那样。
需要时, 可以直接在markdown中写HTML标记内容。 markdown能实现的功能是HTML的一部分, 但是比HTML内容更干净, 没有掺杂过多的与要表达的意思无关的标签。 Markdown的理念是,能让文档更容易读、写和随意改。
**Markdown 语法的目标是:成为一种适用于网络的书写语言。**
由于Markdown的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,目前许多网站都广泛使用Markdown来撰写帮助文档或是用于论坛上发表消息。如GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书等,甚至还能被用来撰写电子书。
在搭建博客系统或编写线简历等涉及文本内容展示的业务场景下,使用markdown进行书写和展示,会使内容排版更加简洁美观,在不同设备下展示兼容性更加友好,并且支持内嵌html、流程图、代码块等功能使得撰写过程更加灵活易用。
**Markdown官方教程**:https://markdown.com.cn/
**这里还有一个在线编辑器**:https://markdown.com.cn/editor/
> 总结一下,那就是,即便不解析markdown格式了,所有的帖子依然具备相当强的阅读性。
>
>而Markdwon这个优点,是html标签,bbcode均不具备的。
>
>可能我这样说,没有什么说服力,来让我们看看图片
>
>
>
>所以,大家看完了这个,相信也知道MarkDown格式相对于以前的各种书写格式有着非常强的优势。
>
>这也是为啥我从建站开始就一直坚持使用Markdown的原因
好了废话不多说了,大家看教程吧。
## 附:本地书写Markdown格式文本的软件推荐
### Typora `重点推荐`
官方网站:https://typoraio.cn/
白嫖地址:https://juse.lanzouw.com/ikHI10v0qyre
Typora是一款轻便简洁的Markdown编辑器,支持即时渲染技术,这也是与其他Markdown编辑器最显著的区别。即时渲染使得你写Markdown就想是写Word文档一样流畅自如,不像其他编辑器的有编辑栏和显示栏。
### 黑曜石Markdown笔记 Obsidian
项目地址:https://obsidian.md/
Obsidian 是一款笔记和知识管理应用程序,也是一个强大的跨平台笔记软件,Obsidian 的数据存储在 Markdown 文件的本地文件夹中。 该应用程序强大的链接和反向链接功能将这些单独的文件变成一个知识库,作为您的第二大脑运行。 很多人最初对应用程序不知所措,直到发现可以通过插件添加的广泛功能。 开发人员将其用作任务管理器、软件开发知识库以及笔记、想法和代码片段的存储库。 它因其开放的架构、可扩展性、代码块、GitHub 集成、Vim 键绑定和可配置的热键而受到赞赏。
### QOwnNotes(开源Markdown笔记本)
官网:https://www.qownnotes.org/
QOwnNotes是开源的记事本,具有 Markdown支持 和针对GNU / Linux,Mac OS X和Windows的待办事项列表管理器,可与Nextcloud Notes 和ownCloud Notes一起使用。
### VNote(开源Markdown笔记)
官网(Github镜像):https://gitee.com/tamlok/vnote
绿色版(64bit):https://juse.lanzouw.com/i278m0v1ejzg
VNote官方版是一款基于qt的专业笔记型软件。VNote最新版界面简约、操作轻松、功能全面,专注于Markdown,VNote的设计是为了提供舒适的编辑体验,当然这款软件不仅仅是Markdown的简单编辑器,通过提供笔记管理,VNote还可以使记笔记变的更简单、更愉快,所以十分的优异。
### Boostnote(开源Markdown写作工具)
官网:https://boostnote.io/
Boostnote这个软件比较小众,但是却是一款颜值很高的markdown语法的写作工具,什么?MD语法你不知道?markdown语法是一种轻量级的写作词法,并且能通过渲染,达到较好的文档页面。而这个软件,就是一款支持markdown语法的写作软件。
软件基于electron开发,支持多个平台,并且是开源的
面向开发人员的直观,时尚的编辑器。这是适用于Mac,Windows和Linux的完全开源的应用程序。
搜索更多相关主题的帖子:
MarkDown
|
段落(换行/回行问题)
>Markdown的书写格式,稍微区别于普通的文本格式,希望诸君能耐心看完这篇小教程 😃
普通的书写格式,一次回车换行即可。
例如
```
白日依山尽,黄河入海流。
欲穷千里目,更上一层楼。
```
但是markdown会显示为
白日依山尽,黄河入海流。
欲穷千里目,更上一层楼。
---------------------
如果想换行, 输入时要`回车两次`。例如:
```
白日依山尽,黄河入海流。
欲穷千里目,更上一层楼。
```
显示结果为:
白日依山尽,黄河入海流。
欲穷千里目,更上一层楼。
---------------
## `<br>`与`<p>`的区别
其实markdown语法除了大的段落`<p>`换行以外,还支持段内换行`<br>`标签,举个例子
```
First line with a backslash after.\
And the next line.
```
其实就是在结尾处加入一个`\`反斜杠,然后回车输入回行的内容即可
就可以显示为
First line with a backslash after.\
And the next line.
---------------
>这里举个小例子大家就明白为什么这样做了。
打个比方
以下是新闻稿件
>北京时间3月12日凌晨4点,22/23赛季法甲联赛第27轮继续。
>在弗朗西斯勒布雷球场,巴黎圣日耳曼客场2-1绝杀布雷斯特,多赛一场以11分的优势领跑。
>索莱尔首开纪录,霍诺拉特扳平比分,梅西助攻姆巴佩绝杀,并斩获俱乐部生涯第300次助攻。
这是编辑器中你书写的格式

这样一来,我们可以利用编辑器的单行回行,将一长段的文字拆分开编辑,并且保持发布后不改变这个长段,更利于写作。
------------
此外,对于目前大多数人的阅读习惯。
过长的文字已经不具备可读性了,所以大家灵活运用吧 😁
|
|
段内文字格式
## 加粗
格式为`**需要加粗的文字**`
显示为
**需要加粗的文字**
## 斜体字
格式为`*需要斜体的文字*`
显示为
*需要斜体的文字*
## 那斜体加粗呢?
格式为`***需要斜体加粗的文字***`
显示为
***需要斜体加粗的文字***
## 删除线
格式为`~~需要删除线的文字~~`
显示为
~~需要删除线的文字~~
## 分割线
格式为`----------------------`
显示为
这是分割线
-------------------------------
这是分割线
|
|
引用段落
可以用类似Email的回复包含原始邮件内容的办法输入引用段落, 即,在段落的每行前面加一个大于号。 比如下面的诗:
```
> 白日依山尽,黄河入海流。
> 欲穷千里目,更上一层楼。
```
转换成
> 白日依山尽,黄河入海流。
> 欲穷千里目,更上一层楼。
注意引用也是段落模式,内容中的换行不起作用,空行导致分段。
引用段落也可以仅在段落第一行写大于号, 其它行顶格写,例如下面的两段引用:
```
> 远上寒山石径斜,
白云生处有人家。
>
> 停车坐爱枫林晚,
霜叶红于二月花。
```
显示为
> 远上寒山石径斜,
白云生处有人家。
>
> 停车坐爱枫林晚,
霜叶红于二月花。
引用也可以嵌套,如:
```
> 张三说:李四这样说过
>
>> 不想当将军的木匠不是好厨子。
>
```
显示为
> 张三说:李四这样说过
>
>> 不想当将军的木匠不是好厨子。
>
|
|
文章内标题
示例:
```
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题
```
显示为
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题
|
|
贴内图片
贴内图片,其格式为
```

```
显示为

<div class="i">关于图床,
请看<a href="/viewthread.php?tid=173">这里</a></div>
|
|
表格
在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
|
|
文章内代码
代码块是使用上下三个连续的“ **`** ”符号来表达

显示为
```
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"
|
|
|