• 手机版

    扫码体验手机版

  • 官方QQ交流群

    扫码加入群聊

游客您好
第三方账号登陆
  • 点击联系客服

    在线时间:8:00-16:00

    客服QQ

    102466633

    电子邮件

    service@zmtyxs.com
  • 手机访问

    随时关注学习动态

  • 扫描二维码

    加入官方交流群

Lv.9 管理员
1号会员,172活跃度,2019/01/02 加入学习
  • 198发帖
  • 153主题
  • 0关注
  • 5粉丝
这个人很懒,什么也没有留下。
优秀讲师更多
课堂交流更多

[公告] 自媒体研习社Markdown编辑器使用说明

[复制链接]
admin 发表于 2019-11-14 14:42:06 | 显示全部楼层 |阅读模式 打印 上一主题 下一主题

Markdown编辑器使用说明

自媒体研习社论坛目前支持使用Markdown发帖了!现在将Markdown使用方法进行一下说明!

使用方法

点击编辑器工具栏“MD”按钮,输入markdown代码

[md]在这里输入你的Markdown代码[ /md]   #实际写作时 [ /md]没有空格,这里为演示加的空格

标题

atx 形式,注意:#与标题文字之间要加一个空格才会生效!

# 一级标题  
## 二级标题
### 三级标题
#### 四级标题
....

一级标题

二级标题

三级标题

四级标题

....  

Setext 形式

h1
========

h2
------------

h1

h2

表格

| 姓名        | 性别         | 班级 |
| ------------- |:-------------:| -----:|
|猪小妹      | 女 | 三年一班|
| 王小明     | 男      |   三年二班 |
| 张大力| 男      |    三年四班 |

注意:| ------------- |:-------------:| -----:|三者在表格中显示的位置,居左,居中,居右显示。

效果如下:

姓名 性别 班级
猪小妹 三年一班
王小明 三年二班
张大力 三年四班

粗斜体

*斜体文本*    _斜体文本_
**粗体文本**    __粗体文本__
***粗斜体文本***    ___粗斜体文本___

斜体文本  斜体文本

粗体文本  粗体文本

粗斜体文本   粗斜体文本

链接

常用链接方法

文字链接 [链接名称](http://链接网址)

网址链接 <http://链接网址>

举例
 [自媒体研习社](https://www.zmtyxs.com)
 <https://www.zmtyxs.com>

自媒体研习社

https://www.zmtyxs.com

高级链接技巧

这个链接用 1 作为网址变量 [Google][1].
这个链接用 yahoo 作为网址变量 [Yahoo!][yahoo].
然后在文档的结尾为变量赋值(网址),这样可以节省时间,统一赋值。
如果你需要插入多个相同的链接,直接用[1]代替,然后文档结尾对[1]进行赋值即可。

  [1]: http://www.google.com/
  [yahoo]: http://www.yahoo.com/

注意:这里的数字 1 不要与文中其他变量重复,否则会冲突,请保持唯一,除非你要引用的是同一个地址!

这个链接用 1 作为网址变量 Google.

这个链接用 yahoo 作为网址变量 Yahoo!.

然后在文档的结尾为变量赋值(网址)

列表

普通无序列表

- 列表文本前使用 [减号+空格]
+ 列表文本前使用 [加号+空格]
* 列表文本前使用 [星号+空格]
  • 列表文本前使用 [减号+空格]
  • 列表文本前使用 [加号+空格]
  • 列表文本前使用 [星号+空格]

普通有序列表

1. 列表前使用 [数字+空格]
2. 我们会自动帮你添加数字
7. 不用担心数字不对,显示的时候我们会自动把这行的 7 纠正为 3
  1. 列表前使用 [数字+空格]
  2. 我们会自动帮你添加数字
  3. 不用担心数字不对,显示的时候我们会自动把这行的 7 纠正为 3

列表嵌套

1. 列出所有元素:
    - 无序列表元素 A
        1. 元素 A 的有序子列表
    - 前面加四个空格
2. 列表里的多段换行:
    前面必须加四个空格,
    这样换行,整体的格式不会乱
3. 列表里引用:

        &gt; 前面空一行  
        &gt; 需要缩进,顶格将打断列表  
        &gt; 换行需要加两个以上空格并回车

4. 列表里代码段:

    ```
    前面四个空格,之后按代码语法 ``` 书写
    ```

        或者直接八个空格,引入代码块
  1. 列出所有元素:

    • 无序列表元素 A
      1. 元素 A 的有序子列表
    • 前面加四个空格
  2. 列表里的多段换行:
    前面必须加四个空格,
    这样换行,整体的格式不会乱

  3. 列表里引用:

    前面空一行
    需要缩进,顶格将打断列表
    换行需要加两个以上空格并回车

  4. 列表里代码段:

    前面四个空格,之后按代码语法 ``` 书写
    或者直接八个空格,引入代码块

引用

普通引用

> 引用文本前使用 [大于号+空格]  
> 折行可以不加,新起一行都要加上哦

引用文本前使用 [大于号+空格]
折行可以不加,新起一行都要加上哦

引用里嵌套引用

> 最外层引用
>> 多一个 &gt; 嵌套一层引用
>>> 可以嵌套很多层

最外层引用

多一个 > 嵌套一层引用

可以嵌套很多层

引用里嵌套列表

> - 这是引用里嵌套的一个列表
> - 还可以有子列表
>     * 子列表需要从 - 之后延后四个空格开始
  • 这是引用里嵌套的一个列表
  • 还可以有子列表
    • 子列表需要从 - 之后延后四个空格开始

引用里嵌套代码块

>     同样的,在前面加四个空格形成代码块
>  
> ```
> 或者使用 ``` 形成代码块
> ```
同样的,在前面加四个空格形成代码块
或者使用 ``` 形成代码块

图片

跟链接的方法区别在于前面加了个感叹号 !,这样是不是觉得好记多了呢?

![图片名称](http://图片网址)

图片名称

当然,你也可以像网址那样对图片网址使用变量

这个链接用 5 作为网址变量  ![Baidu][5].  
然后在文档的结尾位变量赋值(网址)

 [5]: https://www.baidu.com/img/bdlogo.png

这个链接用 5 作为网址变量  

Baidu.  

然后在文档的结尾位变量赋值(网址)

换行

如果另起一行,只需在当前行结尾加 2 个空格

在当前行的结尾加 2 个空格
这行就会新起一行
如果是要起一个新段落,只需要空出一行即可。

分隔符(横线)

如果你有写分割线的习惯,可以新起一行输入三个减号 -:

---

上面是分隔符

符号转义

如果你的描述中需要用到 markdown 的符号,比如 _ # * 等,但又不想它被转义,这时候可以在这些符号前加反斜杠,如 \_ \# \* 进行避免。

\_不想这里的文本变斜体\_
\*\*不想这里的文本被加粗\*\*

_不想这里的文本变斜体_
**不想这里的文本被加粗**

代码

行内代码

如果只想高亮正文中某个词,可以用两个反引号包裹起来

`行内代码`

这是行内代码

如果行内代码包含反引号,可以用多个反引号包裹

包含``反引号(`) `` 的行内代码

输出:包含反引号(`) 的行内代码

如果行内代码开头就有反引号,需要起始端和结束端各一个空格

`` `反引号` ``

输出:`反引号`

普通代码

反引号包裹

用3个或以上的反引号包裹起来

```
# rewrite`s rules for wordpress pretty url 
LoadModule rewrite_module  modules/mod_rewrite.so
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php [NC,L]
````
波浪线包裹

使用3个及以上的波浪线包裹代码

~~~
# rewrite`s rules for wordpress pretty url 
LoadModule rewrite_module  modules/mod_rewrite.so
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php [NC,L]
~~~~
缩进

4个空格或者一个制表符

        # rewrite`s rules for wordpress pretty url 
        LoadModule rewrite_module  modules/mod_rewrite.so
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteCond %{REQUEST_FILENAME} !-d
        RewriteRule . index.php [NC,L]

显示效果

# rewrite`s rules for wordpress pretty url
LoadModule rewrite_module  modules/mod_rewrite.so
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php [NC,L]
特殊字符

当代码中有这些特殊字符时,可以缩进、波浪线、反引号嵌套使用,例如

        ~~~
        ```
            # rewrite`s rules for wordpress pretty url 
            LoadModule rewrite_module  modules/mod_rewrite.so
            RewriteCond %{REQUEST_FILENAME} !-f
            RewriteCond %{REQUEST_FILENAME} !-d
            RewriteRule . index.php [NC,L]
        ````
        ~~~~

输出效果如下:

~~~
```
    # rewrite`s rules for wordpress pretty url 
    LoadModule rewrite_module  modules/mod_rewrite.so
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule . index.php [NC,L]
````
~~~~

已知问题

由于和discuz代码冲突,下文discuz代码均加了反斜杠

Discuz代码冲突

discuz可视化编辑器会自动给链接加bbcode代码,由此会带来一些问题

  • 可视化编辑器会识别图片,将图片链接加上[img]标签,将链接加[url]标签
  • 纯文本会将所有链接加[url](不区分图片)

插件已经对此做了处理,保证输出不会有问题。但是再次编辑帖子时看到的链接被discuz加了bbcode。

建议在后台设置默认编辑器为纯文本编辑器,以减少错误。还可以考虑禁用img, audio, flash等标签

更彻底的解决办法,可以修改discuz源代码来解决


您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

官方交流QQ群
785158530

欢迎免费加入

  • 关注官方微信

  • QQ在线客服1

    在线联系

    QQ在线客服2

    在线联系
  • 自媒体研习社
  • 从零开始,教你做一个高质量的自媒体!