【Markdown语法教程】by Arthals



  • 如题,本篇主要是面向哪些希望提升自己的帖子的视觉美感的楼主们XD。
    全文基于简书作者高鸿祥的帖子编写,并加入了一些我使用Markdown以来发现的小细节。

    他的帖子的地址:https://www.jianshu.com/p/191d1e21f7ed


    〇、前言

    Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。——百度百科

    简而言之,Markdown是一种可以将你的文本,经过一些普通的加工,实现一些格式的语言。
    bbs的发帖是支持Markdown的,可以在发帖栏的左侧修改语法,在右侧获得预览,也可以通过其他Markdown编辑器在本地先写好格式之后再复制到发帖栏内。

    推荐的Markdown编辑器:Typora.
    支持Windows、MacOS、Linux系统。链接地址:https://www.typora.io
    展示:截屏2019-11-02下午1.05.31.png


    一、语法简述

    (Tips:如果你并不希望一些符号成为格式化的标识符,可以在这些字符前面添加”\“转义符,将其转化为正常的符号。)

    常用类:
    1、标题 · #:

    # 标题,可以从#(1级标题)叠加至######(6级标题)

    一级标题(#)

    二级标题(##)

    三级标题(###)

    四级标题(####)

    五级标题(#####)
    六级标题(######)

    Tips:在bbs中,出于观感体验,一般使用4级~6级标题,如果使用1级~3级可能会过大。

    2、字体 · *

    主要实现方式是加*

    a.加粗 · **text**

    在文本两侧添加**即可实现

    文本栏:**Arthals**
    预览栏:Arthals

    b.倾斜 · *text*

    在文本两侧添加*即可实现

    文本栏:*Arthals*
    预览栏:Arthals

    c.斜体加粗 · ***text***

    在文本两侧添加***即可实现,可以理解为a、b两者的叠加操作。

    文本栏:***Arthals***
    预览栏:Arthals

    d.删除线 · ~~text~~

    在文本两侧添加~~即可实现

    文本栏:~~Arthals~~
    预览栏:Arthals

    e.下划线

    Markdown没有内置的下划线语法,是通过html实现的,但是bbs并不支持这种用法。

    3、引用 · >

    可以俄罗斯套娃

    在第一行文本左侧添加>即可实现,如果需要嵌套,则在需要嵌套的哪一行左侧在加一个>即可。

    Tips:连续两个回车的话会破坏上层的叠加,如果是第一层中回车会退出引用。如果确实需要两个及以上的回车,请使用shift+enter输入回车,这样可以避免破坏当前的引用。

    文本栏:>Arthals
    预览栏:

    Arthals

    Tips:引用不能间隔文字嵌套。

    4、分割线 · ***

    单行内,三个或三个以上的*或者-,即***或者---即可实现

    文本栏:***
    预览栏:


    Tips:插入要求***号前无文字,但可以有引用符号>

    5、图片 · !

    语法如下:![图片下方注释](图片地址 ''图片标题'')
    详细解释:先打出一个!(英文叹号)然后打出[text]中间填写图片下方注释,如若没有则不必写,再打出(地址 "标题"),注意使用英文括号、双引号,且地址和标题内需要有空格。

    Tips:渐变方法就是直接复制一张图片然后在文本栏中黏贴即可,这样的操作是以Wiki作为图床的,会占用服务器资源,鳕鱼并不赞成这种做法:

    和我有啥关系呢

    但是我的帖子内所有图片都是这么上传的,因为我懒XD

    将图片上传至图床后会给你一个地址,拷贝到括号内即可。示例如下:

    刚才那张图片的文本栏:
    ![和我有啥关系呢](/assets/uploads/files/1572674091210-b87096c0-3bdd-4108-8f80-974ce7f07e76-image.png "鳕鱼的反对")

    Tips:插入要求!号前无文字,但可以有引用符号>

    6、列表 · */-/+/1.
    a.无序列表 · *-+

    *-+其中任意一个符号+空格+内容即可

    文本栏:* Arthals
    预览栏:

    • Arthals

    Tips:插入要求*或+或-号前无文字,但可以有引用符号>

    b.有序列表 · 1.

    数字+“.”+空格+符号即可,允许不从1顺序往下。

    文本栏:1. Arthals
    预览栏:

    1. Arthals
    7、代码 · ```

    在代码的第一行的上一行和最后一行的下一行添加```即可。

    Tips:该符号在键盘上1的左侧。

    文本栏:

    ```
    print("Arthals")

    ```

    预览栏:

    print("Arthals")
    

    Tips:在第一个```的后面可以写语言:

    文本栏:
    ```python
    import Arthals as Art

    ```

    预览栏:

    import Arthals as Art
    
    8、其他
    a.表格

    不推荐使用Markdown写入,推荐使用Excel直接copy成图片后放上来,不然可能会丢失格式。

    b.流程图

    没人用,过了。

    c.超链接

    不常用,在这里仅写出格式:
    [超链接名](超链接地址 "超链接title")
    Tips:不支持直接新标签页打开。


    二、其他

    再次推荐一下Typora编辑器,方便好用,实时预览,忘了具体语法还可以直接通过内置的格式查找到写法!

    跨平台,免费,轻量!

    文章到这里就完结了,如果觉得有帮助不妨点个赞啊QWQ!



  • 标题那个地方有些鬼畜啊,我检查了下我的内容,是正常的,估计是bbs的特性……



  • Markdown语法教程搬运

    click me



  • +1
    同时论坛不支持一小部分markdown语法



  • 流程图不支持
    高级链接不支持
    下划线不支持
    脚注不支持



  • @Arthals 快把这帖子丢到精华区去
    以后找起来就方便多了



  • 同意樓上,不用等贊了,趕緊丟到精華區裡吧


  • 泼墨挥毫

    在贴内加图片现在直接点上传图片就可以啦



  • 所以有不有将语法符号无效化的方法(每次打一堆*号结果加粗了就很烦



  • @TsanconBYin 在前面加转义符\就可以了



  • @Codusk 能不能提高一下照片的大小啊,大家现在从手机传不上去照片,因为太小了



  • 求求了!再来4个赞进精华了啊!鳕鱼那个大鸽子把我申请晾在那里了QWQ


  • 鱼乐社 后勤社 冰道社 轨交社 百游社 TW

    @TsanconBYin 草(辱骂)


 

推荐话题

最近话题

琼ICP备18003777号-1