• 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...
2 1 0

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

管理员 Mr.C
5113 2

本文共计6858个字,预计阅读时长27.4分钟。

目录

什么是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官方教程

这里还有一个在线编辑器

总结一下,那就是,即便不解析markdown格式了,所有的帖子依然具备相当强的阅读性。 而Markdwon这个优点,是html标签,bbcode均不具备的。 可能我这样说,没有什么说服力,来让我们看看图片

图片隐藏,注册或登陆后显示

所以,大家看完了这个,相信也知道MarkDown格式相对于以前的各种书写格式有着非常强的优势。 这也是为啥我从建站开始就一直坚持使用Markdown的原因

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

附:本地书写Markdown格式文本的软件推荐

Typora 重点推荐

官方网站:

白嫖地址:

Typora是一款轻便简洁的Markdown编辑器,支持即时渲染技术,这也是与其他Markdown编辑器最显著的区别。即时渲染使得你写Markdown就想是写Word文档一样流畅自如,不像其他编辑器的有编辑栏和显示栏。

Marktext

Github官网:

特性:是完全自由开源的;支持网页上的表格(非谷歌sheet)复制粘贴(同typora),如下; 其他:不用担心是英文界面,Markdown 语法是通用的,以及跟typora基本通用的快捷键,大多数时候基本不用点击其他按钮;

黑曜石Markdown笔记 Obsidian

项目地址:

Obsidian 是一款笔记和知识管理应用程序,也是一个强大的跨平台笔记软件,Obsidian 的数据存储在 Markdown 文件的本地文件夹中。 该应用程序强大的链接和反向链接功能将这些单独的文件变成一个知识库,作为您的第二大脑运行。 很多人最初对应用程序不知所措,直到发现可以通过插件添加的广泛功能。 开发人员将其用作任务管理器、软件开发知识库以及笔记、想法和代码片段的存储库。 它因其开放的架构、可扩展性、代码块、GitHub 集成、Vim 键绑定和可配置的热键而受到赞赏。

QOwnNotes(开源Markdown笔记本)

官网:

QOwnNotes是开源的记事本,具有 Markdown支持 和针对GNU / Linux,Mac OS X和Windows的待办事项列表管理器,可与Nextcloud Notes 和ownCloud Notes一起使用。

VNote(开源Markdown笔记)

官网(Github镜像):

绿色版(64bit):

VNote官方版是一款基于qt的专业笔记型软件。VNote最新版界面简约、操作轻松、功能全面,专注于Markdown,VNote的设计是为了提供舒适的编辑体验,当然这款软件不仅仅是Markdown的简单编辑器,通过提供笔记管理,VNote还可以使记笔记变的更简单、更愉快,所以十分的优异。

Boostnote(开源Markdown写作工具)

官网:

Boostnote这个软件比较小众,但是却是一款颜值很高的markdown语法的写作工具,什么?MD语法你不知道?markdown语法是一种轻量级的写作词法,并且能通过渲染,达到较好的文档页面。而这个软件,就是一款支持markdown语法的写作软件。

软件基于electron开发,支持多个平台,并且是开源的

面向开发人员的直观,时尚的编辑器。这是适用于Mac,Windows和Linux的完全开源的应用程序。

段落

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

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

例如

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

但是markdown会显示为

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


如果想换行, 输入时要回车两次。例如:

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

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

显示结果为:

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

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

段内文字格式

加粗

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

显示为

需要加粗的文字

斜体字

格式为*需要斜体的文字*

显示为

需要斜体的文字

那斜体加粗呢?

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

显示为

需要斜体加粗的文字

删除线

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

显示为

需要删除线的文字

分割线

格式为----------------------

显示为

这是分割线


这是分割线

引用段落

可以用类似Email的回复包含原始邮件内容的办法输入引用段落, 即,在段落的每行前面加一个大于号。 比如下面的诗:

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

转换成

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

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

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

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

显示为

远上寒山石径斜, 白云生处有人家。

停车坐爱枫林晚, 霜叶红于二月花。

引用也可以嵌套,如:

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

显示为

张三说:李四这样说过

不想当将军的木匠不是好厨子。

文章内标题

示例:

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

显示为

图片隐藏,注册或登陆后显示

这里说一下,发帖的起始段落尽量使用二级标题,也就是##,因为一级标题是咱们当前页面的名称(也就是你帖子的标题),这样有利于各种搜索引擎的收录以及咱们独有的文章右侧索引的收录

贴内图片

贴内图片,其格式为

![图片描述](图片地址)

显示为

图片隐藏,注册或登陆后显示

关于图床, 请看

表格

在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
7
Mike 3
5
8

文章内代码

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

图片隐藏,注册或登陆后显示

显示为

function getage(age){
  return age
}

文字内的代码呢?

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

显示为

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

有序列表,无序列表

有序列表

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

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

显示为

考试排名:

  1. 小红
  2. 小陈
  3. 小李

无序列表

使用符号+ - *任意一个都可以。

注意:不能混用。自动划分,不同符号创建的列表

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

显示为

  • 水果
  • 香蕉
  • 桃子
  • 苹果
    • 水果
    • 香蕉
    • 桃子
  • 苹果
  • 水果
  • 香蕉
    • 桃子
  • 苹果

链接

行内式 格式为:

[链接文字](地址)

例如:

[百度首页]()

效果如下:

参考式

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

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

语法说明:

参考式链接分为两部分:首先写

[链接文字][链接标记]

然后在文本的任意位置写

[链接标记]:地址 "标题"

例如:

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

[1]:""
[2]:""
[3]:""

显示为

我经常去的几个网站是

字体、字号、颜色

例1:指定字体

<font face="隶书"> 我是隶书 </font>

效果:

我是隶书

例2:指定字号

size的取值范围:从 1 到 7 ,浏览器默认值是 3。

<font size=5 > 我的size = 5 </font>

效果:

我的size = 5

例3:指定颜色

<font color=red> 我的color=red </font>

效果:

我的color=red

背景色

Markdown本身不支持背景色设置,需要采用内置html的方式实现。借助 table,tr, td 等表格标签的 bgcolor 属性,或者DIV的style=background-color: #XXX;来实现背景色功能。

举例:

<div style="background-color:orange;">背景色是橙色</div>

效果:

背景色是橙色

关于Bilibili的视频

比如你想转载一篇B站的视频,又不会粘贴怎么办呢?

看下图,点这个复制嵌入代码

图片隐藏,注册或登陆后显示

点击后它会提供给你一串代码,类似这个

图片隐藏,注册或登陆后显示

直接粘贴过来是这样的

视频隐藏,注册或登陆后显示
视频隐藏,注册或登陆后显示

那么小。。。。显然会让你不爽是不是。别着急,我们往下看

我们要做的是,复制下面我给你的代码,并将你复制的代码中aid=后面的数字cid=后面的数字填入下面的代码即可。

<iframe id=sbrxp src="// scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true" style="width: 1000px; height: 640px; max-width: 100%"> </iframe>

实在不懂就看图

图片隐藏,注册或登陆后显示

然后就可以啦~~~

演示一下

视频隐藏,注册或登陆后显示
视频隐藏,注册或登陆后显示

使用短代码的方式(实验性)

图片隐藏,注册或登陆后显示

代码bilibili

依然还是看复制过来代码的aid=后面的数字,将后面的数字填入

[bilibili]aid后面的数字[/bilibili]

显示为

视频隐藏,注册或登陆后显示
视频隐藏,注册或登陆后显示

此代码为实验性质,由于没有后面的cid,不知道获取的是不是永久链接,看后续有没有用户反馈吧

举例:在这篇帖子里,我发帖的格式是这样的

图片隐藏,注册或登陆后显示

发帖后显示为

图片隐藏,注册或登陆后显示

关于西瓜视频

嵌入代码

<iframe src="分享视频的数字?autoplay=0" referrerpolicy="unsafe-url" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true" style="width: 1000px; height: 640px; max-width: 100%" allowfullscreen></iframe>

显示为

视频隐藏,注册或登陆后显示
视频隐藏,注册或登陆后显示

如果还不懂就看图

图片隐藏,注册或登陆后显示

使用短代码的方式(实验性)

见图

图片隐藏,注册或登陆后显示

代码ixigua

依然还是看复制过来代码的/iframe/后面的数字,将后面的数字填入

[ixigua]分享视频的数字[/ixigua]

显示为

视频隐藏,注册或登陆后显示
视频隐藏,注册或登陆后显示

一些发帖格式的代码块

这些代码块为了防止解析,我用的是全角字符,咱们发帖时直接关闭输入法使用普通半角字符就好

information信息块

HTML格式

<div class="i">这里是information信息</div>

短代码格式

[i]information信息块[/i]

显示为

这里是information信息块

warning信息块

HTML格式

<div class="w">这里是warning信息块</div>

短代码格式

[w]这里是warning信息块[/w]

显示为

这里是warning信息块

danger信息块

HTML格式

<div class="d">这里是danger信息块</div>

短代码格式

[d]这里是danger信息块[/d]

显示为

这里是danger信息块

回复可见

来了啊,万恶的回复可见来了

关于要不要添加回复可见,我纠结了很久,但是和几个做网站的大佬聊了聊,看来还是有必要的,尤其现在仿站采集太多了,对于资源交流类的网站,尤其是比较好扒的站,一行代码,泡杯茶,你所有辛苦收集来资源就让他拿走了,所以添加回复可见,游客不可见等权限限制,还是很有必要的

代码(我用的是全角字符,大家使用的时候将全角字符改成普通的英文字符即可)

[hide]隐藏内容[/hide]

或者

[reply]回复可见的隐藏内容[/reply]
显示为

本帖有部分隐藏内容,会员回复可见

本帖有隐藏内容,请您后查看。

登录可见

我们还设置了登录可见,将你不希望游客看到的内容用

[login]需要游客登录可见的内容[/login]

圈起来(我用的是全角字符,大家使用的时候将全角字符改成普通的英文字符即可)

显示为

此处有隐藏内容,请您后查看。

TAGS

最后于 1天前 被 Mr.C 编辑
本站内容均为会员发表,并不代表本站立场!
请诸君在讨论时务必遵守中华人民共和国中华人民共和国相关法律!
良言一句三冬暖,恶语伤人六月寒,请诸位换位思考,理性讨论。
如果你觉得帖子不错,请点赞、收藏、投币支持楼主(投币每人每天能投三次哦)

最新回复 ( 2 )
  • 管理员 Mr.C
    0 沙发

    最近添加了一些短代码,让各位发帖更容易憨笑

    最后于 2月前 被 Mr.C 编辑
  • 管理员 Mr.C
    0 藤椅
    更新了开源的Marktext本地编辑器
  • 游客
    藤椅

    您需要登录后才可以回帖

    立即登录 立即注册