查看: 57357|回复: 137
收起左侧

【官方】编辑器Markdown语法使用说明-专注于书写

邀请回答

马上注册,享受更多特权

您需要 登录 才可以下载或查看,没有帐号?立即注册   

x
本网站编辑器支持Markdown,可以不用下载下面这个编辑器。

Markdown是一种纯文本格式的标记语言。通过简单的标记语法,它可以使普通文本内容具有一定的格式。相比普通编辑器

优点:

1、因为是纯文本,所以只要支持Markdown的地方都能获得一样的编辑效果,可以让作者摆脱排版的困扰,专心写作。
2、操作简单。比如:普通编辑时标记个标题,先选中内容,再点击导航栏的标题按钮,选择几级标题。要三个步骤。而Markdown只需要在标题内容前加#即可

缺点:

1、需要记一些语法(当然,是很简单。五分钟学会)。

汇川技术社区使用markdown编辑器的方式:

2222.png

11111.png

一、标题

在想要设置为标题的文字前面加#来表示
一个#是一级标题,二个#是二级标题,以此类推。支持六级标题。
注:标准语法一般在#后跟个空格再写文字,貌似简书不加空格也行。
示例:

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

效果如下:

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题
这是六级标题

二、字体

加粗
要加粗的文字左右分别用两个*号包起来

斜体
要倾斜的文字左右分别用一个*号包起来

斜体加粗
要倾斜和加粗的文字左右分别用三个*号包起来

删除线
要加删除线的文字左右分别用两个~~号包起来

示例:

**这是加粗的文字**
*这是倾斜的文字*`
***这是斜体加粗的文字***
~~这是加删除线的文字~~

效果如下:

这是加粗的文字
这是倾斜的文字`
这是斜体加粗的文字
这是加删除线的文字

三、引用

在引用的文字前加>即可。引用也可以嵌套,如加两个>>三个>>>
n个...
貌似可以一直加下去,但没神马卵用
示例:

>这是引用的内容
>>这是引用的内容
>>>>>>>>>>这是引用的内容

效果如下:

这是引用的内容

这是引用的内容

这是引用的内容

四、首行缩进

由于markdown语法主要考虑的是英文,所以对于中文的首行缩进并不太友好,两种方法都可以完美解决这个问题。

把输入法由半角改为全角。 两次空格之后就能够有两个汉字的缩进。
在开头的时候,先输入下面的代码,然后紧跟着输入文本即可。分号也不要掉。 直接写

  这就是首行缩进的效果,使用的是第【2】个全角符号,前面打2个全角符号&emsp ;

其中【1】半角:指的是半个汉字宽度(1个字节)
其中【2】全角:指的是一个汉字宽度(2个字节)
其中【3】代表连续的空格

五、颜色写法

简书的markdown非常好用, \color{#f17c67}{为了追求极致的简洁}, 简书Markdown编辑器默认使用黑色的文字, 然而, 世界本就是\color{#4285f4}{丰}\color{#ea4335}{富}\color{#fbbc05}{多}\color{#34a853}{彩}的, 为文字上色也是一项必不可少的技能(此技能在简书手机app观看, 中文字符可能无法显示)~

PC版预览1

PC版预览2
给文字加颜色
添加红色
效果: $\color{red}{red}$

写法: $\color{red}{red}$

添加绿色
效果: $\color{green}{green}$

写法: $\color{green}{green}$

添加蓝色
效果:$\color{blue}{blue}$

写法: $\color{blue}{blue}$

添加清漾青(支持更丰富的16进制颜色)
效果: $\color{#376956}{cyan-blue}$

写法: $\color{#376956}{cyan-blue}$

为句子中的字加颜色
为句子内的中文字符加颜色
效果: $\color{#4285f4}{更}\color{#ea4335}{丰}\color{#fbbc05}{富}\color{#4285f4}{的}\color{#34a853}{颜}\color{#ea4335}{色}$

写法: $\color{#4285f4}{更}\color{#ea4335}{丰}\color{#fbbc05}{富}\color{#4285f4}{的}\color{#34a853}{颜}\color{#ea4335}{色}$

为句子内的英文字符加颜色, 字符会变为衬线体加斜体 haha...
效果:  $\color{#4285f4}{G}\color{#ea4335}{o}\color{#fbbc05}{o}\color{#4285f4}{g}\color{#34a853}{l}\color{#ea4335}{e}$

写法: $\color{#4285f4}{G}\color{#ea4335}{o}\color{#fbbc05}{o}\color{#4285f4}{g}\color{#34a853}{l}\color{#ea4335}{e}$

小结:
事实上,打开浏览器开发者工具, 我们会发现 为上面的文字添加颜色, 并不是用网页中css属性控制的, 而是Markdown编辑器把字符转换成了图片, 所以这种改变颜色的写法并不能套用到font-size等其它css属性上, 改变图片颜色的方法, 就当是简书markdown编辑器的一个小彩蛋吧~

六、分割线

三个或者三个以上的 - 或者 * 都可以。
示例:

---
----
***
*****

效果如下:
可以看到,显示效果是一样的。





七、图片

语法:

![图片alt](图片地址 ''图片title'')

图片alt就是显示在图片下面的文字,相当于对图片内容的解释。
图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加

示例:
blockchain

效果如下:

blockchain

上传本地图片直接点击导航栏的图片标志,选择图片即可

八、超链接

语法:

[超链接名](超链接地址 "超链接title")
title可加可不加

示例:

[简书](http://jianshu.com)
[百度](http://baidu.com)

效果如下:
简书
百度

注:Markdown本身语法不支持链接在新页面中打开,貌似简书做了处理,是可以的。别的平台可能就不行了,如果想要在新页面中打开的话可以用html语言的a标签代替。
<a href="超链接地址" target="_blank">超链接名</a>

示例
<a href="https://www.jianshu.com/u/1f5ac0cf6a8b" target="_blank">简书</a>

九、列表

无序列表

语法:
无序列表用 - + * 任何一种都可以

- 列表内容
+ 列表内容
* 列表内容

注意:- + * 跟内容之间都要有一个空格

效果如下:

  • 列表内容
  • 列表内容
  • 列表内容

有序列表

语法:
数字加点

1.列表内容
2.列表内容
3.列表内容

注意:序号跟内容之间要有空格

效果如下:
1.列表内容
2.列表内容
3.列表内容

列表嵌套

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

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

4. 列表里代码段:

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

        或者直接八个空格,引入代码块

实际效果:

  1. 列出所有元素:

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

  3. 列表里引用:

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

  4. 列表里代码段:

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

十、表格

语法:

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

实际效果:

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

本文来自互联网,版权归原作者所有




点评

谢谢分享  发表于 2023-5-19 10:15
感谢分享  发表于 2023-2-22 17:37
很好的知识  发表于 2023-1-13 08:40
感谢分享,内容详细  发表于 2022-10-6 23:03
谢谢分享  发表于 2022-4-7 19:22

评分

参与人数 4水滴 +12 贡献 +20 收起 理由
shilingabc + 2 + 8
风雨轩 + 4 很给力!
自动化 + 8 很给力!
前任站长-朱子文 + 10 markdown很好用,欢迎大家使用。这个是评分.

查看全部评分





上一篇:【官方】INOVANCE论坛快速上手指南
下一篇:【官方】汇川技术社区意见收集帖-bug反馈帖-用户体验优化帖

已有 0 人打赏作者

回复 邀请回答送花

使用道具 举报

我太难了 2020-4-16 14:00:11 | 显示全部楼层
这个颜色用法没怎么看懂,能在说明一下吗?

点评

感谢分享,内容详细  发表于 2022-10-6 23:02
回复 送花

使用道具 举报

Inovance版主 2020-4-16 16:12:54 | 显示全部楼层
我太难了 发表于 2020-4-16 14:00
这个颜色用法没怎么看懂,能在说明一下吗?

加颜色功能失效了,你百度一下吧,看看有没有解决方案

点评

感谢分享  发表于 2023-2-18 10:22
回复 送花

使用道具 举报

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

本版积分规则

有技术问题,就上汇川技术社区

INOVANCE汇川技术 公众号

扫码下载掌上汇川APP

全国服务热线:8:30-17:30

4000-300124

苏州地址:江苏省苏州市吴中区越溪友翔路16号

深圳地址:深圳市龙华新区观澜街道高新技术产业园汇川技术总部大厦

Copyright © 2003-2100 汇川技术 Powered by Discuz! X3.4 ( 苏ICP备12002088号 )
快速回复 返回列表 返回顶部