首页 > 其他分享 >Markdown使用规范

Markdown使用规范

时间:2023-11-27 17:14:34浏览次数:39  
标签:文字 Markdown 代码 单元格 规范 标题 item 使用

Markdown使用规范

目录

0、使用VSCode编写Markdown代码

写在前面
使用一个好用的编辑器来编辑Markdown是很有必要的,这里推荐VSCode。
首先在VSCode上安装下图三个插件,并重启VSCode,便可以愉快的编写Markdown啦~

  • Markdown All in One
  • Markdown Preview Enhanced
  • Markdown Preview Github Styling

插件

1、正文段落

这是一段正文文字,直接编辑文字即可,换行需要在末尾添加两个以上空格再回车
这行就是换行后的文字。可以发现两空格加回车的换行方式会使两行紧挨在一起。

该行是与上面的段落隔了一个空行所形成的一个新的段落。可以发现与上面的段落有了一定的距离,可以看做一个新的段落。

2、标记

加粗文字:**粗体文字**-----粗体文字
斜体文字:*斜体文字*-----斜体文字
斜体加粗文字:***斜体粗体文字***-----斜体粗体文字
删除线文字:~~删除线文字~~-----删除线文字
删除线粗体文字:~~**删除线粗体文字**~~-----删除线粗体文字

3、分割线

使用三个及以上的星号(*)或者破折号(-)或者下划线(_),形成单独一行。


***
---
___

为保证兼容性,建议在分割线行上下都加上一个空行。

4、标题

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

上面的代码显示效果如下:
标题显示

为了保证兼容性,通过一个空格在#和标题之间进行分隔。

5、引用

一行以>开头,形成一段引用。

这是一句引用。
This is a reference.

6、列表

有序列表

以标号加小数点开头,形成有序列表。

1. First item
2. Second item
3. Third item
4. Fourth item

表现形式如下:

  1. First item
  2. Second item
  3. Third item
  4. Fourth item

无序列表

*或者+或者-开头,形成无序列表。

+ First item
+ Second item
+ Third item
+ Fourth item

表现形式如下:

  • First item
  • Second item
  • Third item
  • Fourth item

7、代码段

介绍一下如何在markdown中插入代码段。

段落内嵌代码

在正文中以两个`包含的内容为嵌入式代码:
在Arduino中,有两个函数:一个为setup()函数,另一个为loop()函数。

代码区块

以```开头,以```结尾,形成独立代码片段。

C语言风格如下:

#include <stdio.h>
int main()
{
   /* 我的第一个 C 程序 */
   printf("Hello, World! \n");

   return 0;
}

markdown风格如下:

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

python代码风格如下:

print("hello world")

verilog代码风格如下:

wire [1:0] results ;
assign  results = (a == 1'b0) ? 2'b01 :
                 (b==1'b0) ? 2'b10 :
                 2'b11 ;

也可以使用 制表符(Tab) 或者 4个空格 来形成代码区块。

8、插入图片

![图片标题](图片链接 "可选的图片文本")
[![图片标题](图片链接 "可选的图片文本")](点击图片的超链接)

Markdown All in One
官方教程

图片链接可以是本地的绝对路径链接,可以是相对路径衔接,也可以是网络图片链接

9、插入链接

[超链接显示名](超链接地址 "超链接title")

这是一个链接 Markdown语法

10、公式

这是一个行内公式:\(y=ax+b\)

块内公式(LC谐振频率):

$$
F_{s} =\frac{1}{2\pi \sqrt{LC} } 
$$

\[F_{s} =\frac{1}{2\pi \sqrt{LC} } \]

矩阵:

$$
\begin{Bmatrix}
   a & b \\
   c & d
\end{Bmatrix}
$$

\[\begin{Bmatrix} a & b \\ c & d \end{Bmatrix} \]

11、表格

|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |

| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
表头 表头
单元格 单元格
单元格 单元格
左对齐 右对齐 居中对齐
单元格 单元格 单元格
单元格 单元格 单元格

12、代办事项

- [x] 考英语六级
- [ ] 写论文
- [ ] 组会报告

13、列出全部标题TOC

TOC 全称为 Table of Content,列出全部标题。使用[TOC]命令列出。

目录

参考资料和网址

  1. 菜鸟Markdown教程
  2. Markdown官方教程
  3. 在线的Markdown编辑器
  4. 在线的公式编辑器

标签:文字,Markdown,代码,单元格,规范,标题,item,使用
From: https://www.cnblogs.com/haostudio/p/17859805.html

相关文章

  • 线性规划——Pyhton线性规划求解库PULP的使用
    PuLP是一个用于线性规划(LP)、整数线性规划(ILP)和混合整数线性规划(MILP)问题的Python库。PuLP的全称是"PythonforMathematicalProgramming",它提供了一个简单而强大的工具,使得用户能够定义优化问题、构建数学模型并使用不同的求解器进行求解。PuLP的主要特点之一是其易用性。它允许......
  • linux中使用docker安装rabbitmq
    首先确保linux中docker环境正常运行。1、搜索docker镜像dockersearchrabbitmq2、拉取镜像dockerpullrabitmq3、启动rabbitmqdockerrun-d--namerabbitmq1--restartalways-p15672:15672-p5672:5672rabbitmq4、启动web工具 1)进入容器:dockerexec-itrabbi......
  • Rancher v1.x 使用手册之三 安装Rancher并启用SSL
    安装Rancher并启用SSL为了在RancherServer启用 https 访问,您需要在RancherServer前使用一个代理服务器代理https请求,并能设置http的头参数。我们会在以下的内容中提供一个使用NGINX、HAProxy或者Apache作为代理的例子。当然了,其他工具也是可以的。需求除了一般的RancherServer......
  • Rancher v1.x 使用手册之四—离线安装
    离线安装不可对外访问的网络环境(内网)也是可以启动Rancher服务的。在这种拓扑下,可以通过内网提供的IP或者域名来访问Rancher的操作界面(UI界面)。另外,也可以用HTTP代理或者私有镜像库来配置Rancher。需要注意的是,在内网中启动一个Rancher服务会导致一些特性无效,比如:使用操作......
  • 详解如何使用VSCode搭建TypeScript环境(适合小白)
     搭建Javascript环境因为TypeScript不能直接在浏览器上运行。它需要编译器来编译并生成JavaScript文件。所以需要首先安装好javascript环境,可以参考文章:https://blog.51cto.com/liwen629/7621120全局安装Typescript模块执行下面命令进行安装npminstall-gtypescript安装完成后我......
  • IT 运维服务规范(模板)
    一、总则本部分规定了IT运维服务支撑系统的应用需求,包括IT运维服务模型与模式、IT运维服务管理体系、以及IT运维服务和管理能力评估与提升途径。二、参考标准下列文件中的条款通过本部分的引用而成为本部分的条款。凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内......
  • Idea中使用Debug模式​详解
    Idea中使用Debug模式Debug用来追踪代码的运行流程,通常在程序运行过程中出现异常,启用Debug模式可以分析定位异常发生的位置,以及在运行过程中参数的变化。通常我们也可以启用Debug模式来跟踪代码的运行流程去学习三方框架的源码。Debug开篇首先看下IDEA中Debug模式下的界面。如下是在......
  • 转:在.NET FX 4.8项目中使用C# 8/9/10的新语法
    在.NETFX4.8项目中使用C#8/9/10的新语法吴冬wdhustInnovativeBIMtechniques 受到某些特殊原因的限制,有时候.NET项目被锁死在.NETFramework4.8,而无法升级到.NET5等更高版本,导致代码中能够使用的C#语法最高只能支持到C#7.3,而无法使用C#8及更高版......
  • vue3使用kindeditor富文本编辑器组件,支持上传图片(接口或base64)
    参考文章:https://blog.csdn.net/qq_27936291/article/details/1247689891.安装插件npmi@zhj-target/vue3-kind-editor--save或者yarnadd@zhj-target/vue3-kind-editor2.在vue项目中使用importVue3KindEditorfrom'@zhj-target/vue3-kind-editor'conststate=re......
  • Rancher v1.x 使用手册之二安装Rancher
    安装RancherRancher是使用一系列的Docker容器进行部署的。运行Rancher跟启动两个容器一样简单。一个容器作为管理服务器部署,另外一个作为集群节点的Agent部署注意:您可以运行RancherServer的容器的命令 dockerrunrancher/server—help 来获得所有选项以及帮助信息。安装需求......