找回密码
 立即注册

只需一扫,快速开始

QQ登录

只需一步,快速开始

搜索
楼主: admin

[教程分享] Markdown使用语法参考

   火... [复制链接]

8万

主题

417

回帖

9万

积分

管理员

积分
94534
QQ
发表于 2019-9-6 00:12:34 | 显示全部楼层 |阅读模式

Vditor 是一款所见即所得编辑器,支持 Markdown

  • 不熟悉 Markdown 可使用工具栏或快捷键进行排版
  • 熟悉 Markdown 可直接排版,也可切换为分屏预览

更多细节和用法请参考 Vditor - 浏览器端的 Markdown 编辑器,同时也欢迎向我们提出建议或报告问题,谢谢 ❤️

Guide

这是一篇讲解如何正确使用 Markdown 的排版示例,学会这个很有必要,能让你的文章有更佳清晰的排版。

引用文本:Markdown is a text formatting syntax inspired

语法指导

普通内容

这段内容展示了在内容里面一些排版格式,比如:

  • 加粗 - **加粗**
  • 倾斜 - *倾斜*
  • 删除线 - ~~删除线~~
  • Code 标记 - Code 标记
  • 超级链接 - 超级链接
  • [email]username@gmail.com[/email] - [[email]username@gmail.com[/email]](mailto:username@gmail.com)

提及用户

@Vanessa 通过 @User 可以在内容中提及用户,被提及的用户将会收到系统通知。

NOTE:

  1. @用户名之后需要有一个空格
  2. 新手没有艾特的功能权限

表情符号 Emoji

支持大部分标准的表情符号,可使用输入法直接输入,也可手动输入字符格式。通过输入 : 触发自动完成,可在个人设置中设置常用表情。

一些表情例子

? ? ? ? ? ? ? ? ? ?
? ? ? ? ? ? ❓ ? ❤️ ☕️ ? ? ? ? ?

大标题 - Heading 3

你可以选择使用 H1 至 H6,使用 ##(N) 打头。建议帖子或回帖中的顶级标题使用 Heading 3,不要使用 1 或 2,因为 1 是系统站点级,2 是帖子标题级。

NOTE: 别忘了 # 后面需要有空格!

Heading 4

Heading 5
Heading 6

图片

!alt 文本
!alt 文本

支持复制粘贴直接上传。

代码块

普通

*emphasize*    **strong**
_emphasize_    __strong__
var a = 1

语法高亮支持

如果在 ``` 后面跟随语言名称,可以有语法高亮的效果哦,比如:

演示 Go 代码高亮
package main

import "fmt"

func main() {
	fmt.Println("Hello, 世界")
}
演示 Java 高亮
public class HelloWorld {

    public static void main(String[] args) {
        System.out.println("Hello World!");
    }

}

Tip: 语言名称支持下面这些:ruby, python, js, html, erb, css, coffee, bash, json, yml, xml ...

有序、无序、任务列表

无序列表

  • Java
    • Spring
      • IoC
      • AOP
  • Go
    • gofmt
    • Wide
  • Node.js
    • Koa
    • Express

有序列表

  1. Node.js
    1. Express
    2. Koa
  2. Go
    1. gofmt
    2. Wide
  3. Java
    1. Latke
    2. IDEA

任务列表

  • 发布 Sym
  • 发布 Solo
  • 预约牙医

表格

如果需要展示数据什么的,可以选择使用表格。

header 1 header 2
cell 1 cell 2
cell 3 cell 4
cell 5 cell 6

隐藏细节

这里是摘要部分。 这里是细节部分。

段落

空行可以将内容进行分段,便于阅读。(这是第一段)

使用空行在 Markdown 排版中相当重要。(这是第二段)

数学公式

多行公式块:

\frac{1}{ \Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{ \frac25 \pi}} = 1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} { 1+\frac{e^{-6\pi}} {1+\frac{e^{-8\pi}}{1+\cdots}} } }

行内公式:

公式 ​a^2 + b^2 = \color{red}c^2 是行内。

流程图

graph TB c1-->a2 subgraph one a1-->a2 end subgraph two b1-->b2 end subgraph three c1-->c2 end

时序图

sequenceDiagram Alice->>John: Hello John, how are you? loop Every minute John-->>Alice: Great! end

甘特图

gantt title A Gantt Diagram dateFormat YYYY-MM-DD section Section A task :a1, 2019-01-01, 30d Another task :after a1 , 20d section Another Task in sec :2019-01-12 , 12d another task : 24d

图表

{ "title": { "text": "最近 30 天" }, "tooltip": { "trigger": "axis", "axisPointer": { "lineStyle": { "width": 0 } } }, "legend": { "data": ["帖子", "用户", "回帖"] }, "xAxis": [{ "type": "category", "boundaryGap": false, "data": ["2019-05-08","2019-05-09","2019-05-10","2019-05-11","2019-05-12","2019-05-13","2019-05-14","2019-05-15","2019-05-16","2019-05-17","2019-05-18","2019-05-19","2019-05-20","2019-05-21","2019-05-22","2019-05-23","2019-05-24","2019-05-25","2019-05-26","2019-05-27","2019-05-28","2019-05-29","2019-05-30","2019-05-31","2019-06-01","2019-06-02","2019-06-03","2019-06-04","2019-06-05","2019-06-06","2019-06-07"], "axisTick": { "show": false }, "axisLine": { "show": false } }], "yAxis": [{ "type": "value", "axisTick": { "show": false }, "axisLine": { "show": false }, "splitLine": { "lineStyle": { "color": "rgba(0, 0, 0, .38)", "type": "dashed" } } }], "series": [ { "name": "帖子", "type": "line", "smooth": true, "itemStyle": { "color": "#d23f31" }, "areaStyle": { "normal": {} }, "z": 3, "data": ["18","14","22","9","7","18","10","12","13","16","6","9","15","15","12","15","8","14","9","10","29","22","14","22","9","10","15","9","9","15","0"] }, { "name": "用户", "type": "line", "smooth": true, "itemStyle": { "color": "#f1e05a" }, "areaStyle": { "normal": {} }, "z": 2, "data": ["31","33","30","23","16","29","23","37","41","29","16","13","39","23","38","136","89","35","22","50","57","47","36","59","14","23","46","44","51","43","0"] }, { "name": "回帖", "type": "line", "smooth": true, "itemStyle": { "color": "#4285f4" }, "areaStyle": { "normal": {} }, "z": 1, "data": ["35","42","73","15","43","58","55","35","46","87","36","15","44","76","130","73","50","20","21","54","48","73","60","89","26","27","70","63","55","37","0"] } ] }

五线谱

X: 24 T: Clouds Thicken C: Paul Rosen S: Copyright 2005, Paul Rosen M: 6/8 L: 1/8 Q: 3/8=116 R: Creepy Jig K: Em |:"Em"EEE E2G|"C7"_B2A G2F|"Em"EEE E2G|\ "C7"_B2A "B7"=B3|"Em"EEE E2G| "C7"_B2A G2F|"Em"GFE "D (Bm7)"F2D|\ 1"Em"E3-E3:|2"Em"E3-E2B|:"Em"e2e gfe| "G"g2ab3|"Em"gfeg2e|"D"fedB2A|"Em"e2e gfe|\ "G"g2ab3|"Em"gfe"D"f2d|"Em"e3-e3:|

多媒体

支持 v.qq.com,youtube.com,youku.com,coub.com,facebook.com/video,dailymotion.com,.mp4,.m4v,.ogg,.ogv,.webm,.mp3,.wav 链接解析

https://v.qq.com/x/cover/zf2z0xpqcculhcz/y0016tj0qvh.html

快捷键

我们的编辑器支持很多快捷键,具体请参考 键盘快捷键(或者按 "? "?)

回复

使用道具 举报

8万

主题

417

回帖

9万

积分

管理员

积分
94534
QQ
 楼主| 发表于 2024-12-3 14:27:56 | 显示全部楼层

新版逻辑不同,所以删除了历史的老的测试内容帖子。

有兴趣的可以重新发布测试回帖,新版本无论是兼容性、还是渲染速度,都远远由于老版本。

并且老的帖子仍然有逻辑保持兼容,重新编辑后,将切换到新的逻辑。

回复 支持 反对

使用道具 举报

8万

主题

417

回帖

9万

积分

管理员

积分
94534
QQ
 楼主| 发表于 2024-12-3 14:43:18 | 显示全部楼层

Markdown语法使用要点

1. 标题

使用 #表示标题的级别,#的数量越多,标题级别越低。- # 一级标题

  • ## 二级标题
  • ### 三级标题

2. 段落

段落通过空行分隔。简洁书写,但不会影响格式。

3. 强调

使用 *_来表示强调文本。

  • 斜体斜体
  • 粗体粗体
  • 删除线

4. 列表

无序列表

使用 *-+表示无序列表项。

  • 项目一
  • 项目二
    • 子项目

有序列表

使用数字加点表示有序列表。

  1. 第一项
  2. 第二项
    1. 子项一

5. 链接

格式为 [链接文本](链接地址)

  • 百度

6. 图片

格式为 ![替代文本](图片地址)

  • !示例图片

7. 代码

行内代码

使用反引号放置代码,如 print("Hello, World!")

块代码

使用三个反引号包裹代码块:

def hello():
    print("Hello, World!")

8. 引用

使用 >表示引用文本。

这是一个引用示例。

9. 分隔线

使用三个或更多的短横线、星号或下划线创建分隔线:


10. 表格

使用 |-创建表格。

列1 列2
数据1 数据2

以上是Markdown语法的基本使用要点,能够帮助你高效地构建格式化文本。

回复 支持 反对

使用道具 举报

8万

主题

417

回帖

9万

积分

管理员

积分
94534
QQ
 楼主| 发表于 2025-1-8 14:21:56 | 显示全部楼层

脑图

- 教程 - 语法指导 - 普通内容 - 提及用户 - 表情符号 Emoji - 一些表情例子 - 大标题 - Heading 3 - Heading 4 - Heading 5 - Heading 6 - 图片 - 代码块 - 普通 - 语法高亮支持 - 演示 Go 代码高亮 - 演示 Java 高亮 - 有序、无序、任务列表 - 无序列表 - 有序列表 - 任务列表 - 表格 - 隐藏细节 - 段落 - 链接引用 - 数学公式 - 脑图 - 流程图 - 时序图 - 甘特图 - 图表 - 五线谱 - Graphviz - 多媒体 - 脚注 - 快捷键
回复 支持 反对

使用道具 举报

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

本版积分规则

QQ|Archiver|手机版|小黑屋|站秘书 ( 蜀ICP备15034504号-3 )

GMT+8, 2025-1-28 11:39 , Processed in 0.299262 second(s), 66 queries .

Powered by Discuz! X3.5

© 2001-2025 Discuz! Team.

快速回复 返回顶部 返回列表