【md】1.markdown基础语法

已于 2023-04-08 23:22:24 修改
阅读量6.8k 收藏 38
点赞数 6
分类专栏： markdown 文章标签： 编辑器 学习
于 2022-11-01 22:14:00 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_51929253/article/details/127642028
版权

一、基本文本使用

不是程序员的话，推荐只看本部分。后续的操作虽然也会用到部分，但频率很低，用的时候直接从目录跳转即可。

1、换行

直接回车。

2、段落

（1）、格式

换行两次

（2）、区别富文本中的段落

我们在txt或者docx文件中，通常指的段落就是换行。

但是markdown中，语法是很喜欢留一个空行的，所以完全可以理解为段落间是用一个空行隔开的，只需要回车两次即可。

这是有必要的，就拿我自己遇到的情况来说，早期用vscode记markdown笔记的时候，使用vscode自带预览，里面的规则把回车一次的直接连起来，当成一行的的内容，只有回车两次的才算做另起一段。

但是现在很多编辑器的markdown规则都被优化了许多，基本不存在当初遇到的这个bug，但是习惯性留一个空行还是比较美观的。

（3）、段落与块

有一部分编辑器是以块为单位的，比如思源笔记，Marktext。

个人不太喜欢，了解不太多，但也是用过几次，只能说这一类的操作方式可玩性更高，可既然我用的是markdown，也不需要很多功能的，功能太多对于我来说，熟练成本过高，且不太美观（成也在块，败也在块）。

大家可以都试试，找到属于自己的笔记方式还是很重要的。

3、标题

eg：

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

为了不跟本文标题冲突，所以我用将上面的写法高亮了，所以编辑器没有渲染出来，但写法还是我上面那样的

本小段的标题就是一个三级标题，基本文本使用则是一个二级标题

注意：

  • 最多有六级标题
  • 另一种标题的方式：加等号和减号的，在此处提一下以作了解，不举例，因为比较难用，我自己几乎不会用到
  • 个人觉得markdown的标题辨识度不高，所以要充分运用序号、中文括号和中文顿号

4、分割线

三个*或三个-

用的时候 ---上下两行和左右必须都是空白的

5、无序列表

（1）、格式
- A
- B
	- C  (下面的C与D是嵌套进B的)
	- D
  • A
  • B(下面的C与D是嵌套进B的)
    • C
    • D

此处的-换成+或者*也可

（2）、关于无序列表的样式

某些预览风格的多级无序列表简直丑哭，非常难以辨认级别，所以有多级列表的时候，个人建议有序无序交替使用。

换行后会默认给你加上 -，空格也给你加上了，可以直接写下一行的列表内容。

切换级别的话，上一级换行后直接按 tab 即可，有序列表同理。

在-与后面内容中间可以加上[ ],也可以是[x]，就可以改变样式：

  • A
  • B
    • C
    • D

这种样式的多序列表在一些笔记软件中常和待办清单联系起来，但某些编辑器对此的兼容性不太好，所以用处不大，远不如类似于滴答清单或者番茄TODO系列专门的软件

6、有序列表

1. A
   1. C
   2. D
2. B
   -  C
   -  D
  1. A
    1. C
    2. D
  2. B
    • C
    • D

7、注解

（1）、格式

也叫引用，多用来写一些解释性的文字

> 打字的人是彦祖

打字的人是彦祖

（2）、简单的应用
>d

又：

>d  
>d

又：

>d
>
>d

d

又：

d
d

又：

d

d

解释：

  • 注解的换行方式跟普通文字的换行一致
  • 其他 markdown 编辑器，比如纯纯写作，换行方式可能与 VScode 有所区别，有时候也取决于预览功能的不同

这里的换行方式，主要针对的是需不需要空一行，以及注释的自动合并

（3）、引用的嵌套
>A
>>B
>>>C  
H
>>
>>D
>>>E
>>
>>F
>
>G

A

B

C
H

D

E

F

G

对比着可以看一下，了解即可，基本没用，还是因为编辑器对其的渲染，区分度真的不高，类似的情况还有有序无序列表，用的也不多，也是如此原因

8、简单的表格

| |1|2|3|
|-|-|-|------------|
|1|（1，1）|（1，2）|（1，3）|
|2|（2，1）|（2，2）|（2，3）|
|3|1|1|1|
123
1（1，1）（1，2）（1，3）
2（2，1）（2，2）（2，3）
3111

表格还是挺好的，对于程序员来说更是如此，但markdown中的简单语法只能做出最基本的表格，对于最基本的文本编辑来说，还是够用的。

9、文字：加粗/斜体/删除线

（1）、粗体

**天下剑兵皆入凉**

天下剑兵皆入凉

对应快捷键：
Ctrl + B ——> 将选中部分加粗

有些编辑器上，被加粗的部分不能单独占1行，那一行必须有其他内容，不然就会报错，vscode我绝对不是在说你

（2）、斜体

*我在雪中观剑来*

我在雪中观剑来

（3）、斜体和粗体同时运用

***斜体和粗体同时运用***

斜体和粗体同时运用

（4）、删除线

~~蜜雪冰城甜蜜蜜~~

蜜雪冰城甜蜜蜜

10、图片

（1）、本地图片
![试验图片](D:\BACKGROUND/bg-a887465.bmp)

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-m5WHmPlE-1677937556411)(D:\BACKGROUND/bg-a887465.bmp)]

方括号中是图片的标题，自己随便取，圆括号内要写的是图片路径，这个路径可以是绝对路径，也能是相对路径，懂的人已经知道咋操作了，不会的我在这里很难说清楚，可以自行搜索方法。

需要注意的是，本地图片仅对于本电脑才能用，其他电脑是用不了的，很多编辑器比如obsidian和小书匠，对此给出了解决方案，可直接粘贴图片到文中，编辑器自行将图片备份到当前目录，此种模式本质上是创建了一个相对路径。

（2）、picgo+仓库
![](https://fhzy886.oss-cn-hangzhou.aliyuncs.com/images/img1.jpg)

格式跟本地的方式一样，但圆括号里面的是图片的URL地址，可以看作是此张图片在网络上的地址，本质上还是一个映射，我们使用仓库的目的便是来存图片的，picgo是一个工具，方便我们在仓库和markdown文本预览页面的连接，只需一个快捷键，就可以将二者串连。

说明一下，欲构造 picgo 图床，很多人用的是免费gitee仓库，这样就不可避免地需要选择其中的插件，但是，在 picgo 中安装 gitee 插件必须要在配置好 nodejs 的状况下，按照 CSDN 上的教程，有一定的几率不会碰到问题一把过，但一旦出了问题，只能说非常麻烦，就好比我第一次安装和第二次安装，到最后下包时，都出现了成片的报错，这种情况让人很恼火，因为网上的解决方案少，且不靠谱，不太推荐gitee

还有，我们有时候需要从手机上传图片到电脑，我发现，通过 QQ 传到电脑上的图片，最后生成的链接不可用，在 picgo 上可上传但无法查看，但 gitee 上可上传可查看，所以，需要用到 picgo 的图片尽量用微信文件传输助手传输。

最后，劝诫各位，免费的就是最贵的，尽量采用付费的 OSS 来储存，不要贪小便宜，不然可能会因为当初的贪小便宜而让自己因为数据存储被迫付出更大而代价，比如gitee的防盗锁，当时真的让人头疼

11、链接和邮箱

（1）、直接上链接
<https://www.bilibili.com/>

https://www.bilibili.com/

（2）、文字链接
[哔哩哔哩](https://www.bilibili.com/)

哔哩哔哩

（3）、图片链接
[![](https://fhzy886.oss-cn-hangzhou.aliyuncs.com/images/img2.jpeg)](https://www.bilibili.com/)

（4）、发送邮件给
发送邮件至： 2529053680@qq.com

发送邮件至： 2529053680@qq.com

瞎编的一个邮箱号，不要尝试，，，而且CSDN里好像不支持邮箱的这个写法

二、程序员简单记录使用

1、文字颜色

想要了解更多可以看看这篇博客：http://www.manongjc.com/detail/16-cywlkrjbgkqnakc.html

浅红色文字：<font color="#dd0000">浅红色文字</font>
深红色文字：<font color="#660000">深红色文字</font>
浅绿色文字：<font color="#00dd00">浅绿色文字</font>
深绿色文字：<font color="#006600">深绿色文字</font>
浅蓝色文字：<font color="#0000dd">浅蓝色文字</font> 
深蓝色文字：<font color="#000066">深蓝色文字</font>
浅黄色文字：<font color="#dddd00">浅黄色文字</font>
深黄色文字：<font color="#666600">深黄色文字</font>
浅青色文字：<font color="#00dddd">浅青色文字</font>
深青色文字：<font color="#006666">深青色文字</font> 
浅紫色文字：<font color="#dd00dd">浅紫色文字</font>
深紫色文字：<font color="#660066">深紫色文字</font>

浅红色文字：浅红色文字
深红色文字：深红色文字
浅绿色文字：浅绿色文字
深绿色文字：深绿色文字
浅蓝色文字：浅蓝色文字
深蓝色文字：深蓝色文字
浅黄色文字：浅黄色文字
深黄色文字：深黄色文字
浅青色文字：浅青色文字
深青色文字：深青色文字
浅紫色文字：浅紫色文字
深紫色文字：深紫色文字

这里记住格式和颜色编码，然后在对应位置填上自己想要标记的内容即可。

但是呢，“内容”里面就不能再次套娃了……

2、同时调整字号和文字颜色

记住语法和对应的颜色名称即可

<font color=aqua size=72>helloworld!</font>  (aqua是颜色名称)

<font color=beige size=100>helloworld!</font>

helloworld!

helloworld!

这里改变了字号，但是大小好像并没有变，不知道其他编辑器如何，，，

3、文本的背景色

（1）、方法1
<table><tr><td bgcolor=yellow>背景色yellow</td></tr></table>
<table><tr><td bgcolor=green>背景色green</td></tr></table>
<table><tr><td bgcolor=red>背景色red</td></tr></table>
背景色yellow
背景色green
背景色red

这种方法是有局限性的，就是被标记内容只能独占一行：

打我啊，<table><tr><td bgcolor=yellow>试试就试试</td></tr></table>，不要啊

打我啊，

试试就试试
，不要啊

（2）、方法2

还有一种标记方法：

我好喜欢<mark>张柏芝</mark>啊

我好喜欢张柏芝啊

但是目前找不到其他颜色，也不清楚是不是在所有编辑器中是不是通用的

4、表格的一些用法

（1）、普通列表默认左对齐
| |1|2|3|
|-|-|-|------------|
|1|（1，1）|（1，2）|（1，3）|
|2|（2，1）|（2，2）|（2，3）|
|3|1|1|1|
123
1（1，1）（1，2）（1，3）
2（2，1）（2，2）（2，3）
3111
（2）、调整对齐

可以通过第二行加英文冒号来调节左右居中对齐

| |1|2|3|
|-| :- | :-: | -: |
|1|AAAAAAAAAAAA|AAAAAAAAAAAA|AAAAAAAAAAAA|
|2|AAAAAAAAAAAA|AAAAAAAAAAAA|AAAAAAAAAAAA|
|3|1|1|1|
123
1AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
2AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
3111
（3）、表格中有竖线

有的编辑器用高亮把竖线包起来就行，这是最好的情况，但并不是所有编辑器都允许，就比如我现在在obsidian中用着就不行。

目前发现兼容性较好的一种就是：&#124;

功能获取共享内存ID
头文件#include <sys/shm.h>
原型int shmget(key_t key, size_t size, int shmflg);
参数key_t key key值
size_t size 要申请的共享内存的大小，必须是1024字节的倍数
int shmflg 通常填 IPC_CREAT|0666 ,意思是没有就创建
返回值成功：共享内存的ID号
失败：-1

但是这个 IPC_CREAT|0666 在表格中不能高亮，不然还是有bug

（4）、在表格中换行

用<br>，这玩意不仅仅在表格中可以用，在正文里面也行，对于编辑器对markdown规则的修改能人为对抗一下，不至于让渲染后的文本太难看，

看的有些地方说的要加<br/>，但是obsidian不能加斜杠，应该是obsidian对兼容性做出了调整，毕竟obsidian多多少少必须带一点富文本属性以更加人性化

111111<br>111111111111<br>111111<br>11111111

111111
111111111111
111111
11111111

|功能|设置分离属性到属性变量里|
|-|-|
|头文件|`#include <pthread.h>`|
|原型|`int pthread_attr_setdetachstate(pthread_attr_t *attr, int detachstate);`|
|参数|`pthread_attr_t *attr`属性变量的地址|
||`int detachstate`要设置的属性<br>&#8195;`PTHREAD_CREATE_DETACHED`分离属性<br>&#8195;`PTHREAD_CREATE_JOINABLE`不分离属性，即线程默认属性|
|返回值|成功：0|
||失败：非0的数|
|备注|需要链接`-lpthread`使用|
功能设置分离属性到属性变量里
头文件#include <pthread.h>
原型int pthread_attr_setdetachstate(pthread_attr_t *attr, int detachstate);
参数pthread_attr_t *attr属性变量的地址
int detachstate要设置的属性
 PTHREAD_CREATE_DETACHED分离属性
 PTHREAD_CREATE_JOINABLE不分离属性，即线程默认属性
返回值成功：0
失败：非0的数
备注需要链接-lpthread使用

5、空格和换行

（1）、空格

在用表格的时候学到的，一个字节的空格：&#8194;，两个字节的空格：&#8195;，看我上面在表格中换行的情况，就可以看出了。

但是我在obsidian上并没有成功，但这两兄弟在obsidian的表格里面倒是在可以显示空格，原因依旧怀疑是obsidian的兼容性调整改变了原本你的md语法

可在CSDN的编辑器上是可行的，由此观之，其他编辑器上要看脸，当然，长得帅的人还是可以用的哈哈哈

（2）、换行

用 <br>，正文表格中皆可

6、代码

（1）、单行代码
`printf("hello world!);`

printf("hello world!);

（2）、代码块

#include <stdio.h>
int main()
{
    printf("Hallo,World!");
    return 0;
}

三、工具

1、编辑器的推荐

（1）VScode + gitee + picgo（+坚果云 + 纯纯写作）

这套方案是很懒的穷鬼最方便的全套配置

  • VScode 具有极其强大的插件功能，通过网上搜索教程来调教 VS，完全可以轻松实现 markdown 编写的需求，而且，如今的vscode已经内置markdown模式了，所见即所得

  • gitee 与 picgo 的组合，更是与免费与快速的完美结合

  • 坚果云是用来同步/保存本地内容的，也可以轻松实现三端互通，作为主力的私人云盘，即使是免费版也能基本满足需求，而且，也能在 Android 与 iOS 端用坚果云自带的查阅功能查看 md 笔记。

  • 最后要提到的就是纯纯写作了，在本组合中，作为 VScode 的 Android 端替代品，体验很不错，当然，主要是我入正了哈哈哈哈，但是需要导入进去建立新文章才能看，所以我平时偷懒一般直接用坚果云直接查阅，那体验简直不如纯纯的十分之一。

（2）、obsidian + 阿里云OSS + picgo（+坚果云 + 纯纯写作）

我目前使用的方案，自我感觉良好

  • obsidain是神器，插件和主题很多，所以可玩性很高，优点是一定可以找到最适合自己的md写作状态，缺点也是这样，学习成本较高
  • 阿里云OSS：付费，也需要配置，但不算贵而且教程很多，使用起来比gitee好，而且最重要的是数据安全有保证
  • picgo：用的不是gitee图床，所以压根不用配置环境

2、markdown 语言规范

在一些语法要求不严格的编辑器中，简直随心所欲，

严格的语法一言难尽，而且不同编辑器都有自己的想法，这里也不好描述了，因为我以后压根不会去使用严格语法规范的编辑器了

3、关于picgo

  • 千万不要随便删除picgo相册中的图片，因为会同步仓库中的一起删除
  • picgo现在也有手机版的，容易配置但是不好使用，因为markdown主要是在电脑上使用的
MD基本语法
海里鱼的技术博客
09-07 2万+
md是什么 .md即markdown文件的基本常用编写语法,是一种快速标记、快速排版语言 1.基本符号：* - + > 基本上所有的markdown标记都是基于这四个符号或组合，需要注意的是，如果以基本符号开头的标记，注意基本符号后有一个用于分割标记符和内容的空格。 2.标题 前面带#号，后面带文字，分别表示h1-h6,只到h6，而且h1下面会有一条横线 --> 相当于标签闭合 # 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题
Markdown（MD）——Typora Markdown详细安装教程
m0_72958694的博客
04-12 7241
Typora Markdown超详细安装教程。
Obsidian 自定义快捷键
最新发布
2301_79700060的博客
03-15 284
% tp.file.selection() %> 是占位符，会把选中的文本替换进去。插件，挺好用的一个插件，算是可以真正意义上可以实现自定义快捷键。然后配置一下，添加模板文件。然后点击+号配置快捷键。
Markdown使用教程
John's Blogs
01-07 1260
一文搞定Markdown使用 1 介绍 LOGO 简介 1. Markdown 是一种轻量级标记语言，允许使用易读易写的纯文本格式编写文档。2. Markdown 语言在 2004 由约翰·格鲁伯（英语：John Gruber）创建。3. Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。4. Markdown 编写的文档后缀...
关于md的一些基本语法
qq_55532366的博客
07-24 1609
是一种轻量级的标记语言，使人们使用简单的文本格式来书写、编辑文档。语法简单直观，易于学习和使用，甚至还可以实现对Pdf和Word等格式的转换,是每个程序员都值得掌握的一门语言。是一款功能强大且直观易用的跨平台，它提供了所见即所得的编辑模式，即你所写即时显示为格式化的文本，这种编辑方式使得撰写文档更加直观和高效，还支持快捷键。我整理了一些的语法，希望能帮助到大家。
md 的基本语法
蚁族的奋斗的博客
08-26 651
https://www.jianshu.com/p/f378e3f2e7e1 # md 基本 语法 # 一级标题 ## 二级标题 ## 三级标题 ## 四级标题 ## 单行代码 ` (function(){ var div=document.querySelector(".box") div.onmouseover=function(){ this.style....
MD语法 markdown基础语法（自用查看）
weixin_45097626的博客
07-20 1672
Markdown是一种轻量级标记语言，排版语法简洁，让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档，可与HTML混编，可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写，Markdown被大量使用，如Github、Wikipedia、简书等。
Typora-Markdown基础语法学习.md
09-04
关于Markdown常用语法的简单介绍
markdown基础语法.md
08-23
markdown语法简介
MarkDown基础语法使用.md
04-16
个人学习，不建议下载
markdown基础使用.md
10-14
### Markdown基础使用知识点详解 #### 一、标题 Markdown中使用`#`号来表示不同级别的标题，其中一级标题对应一个`#`号，二级标题对应两个`#`号，以此类推，最多支持六级标题。例如： - 一级标题：`# 这是一级...
obsidian-minimal-settings:设置插件，用于控制“最小主题”中的颜色和字体
05-24
概述 此插件随附，使您可以从“黑曜石设置”面板自定义主题。 使用最小主题不需要此插件，但强烈建议使用。 在 ， 或“上支持我的插件和主题@kepano的开发。 用法 要求最低主题2.0.0最低 “最小主题”与“一起使用，通过删除菜单功能区，工具提示，标题栏，滚动条等来简化黑曜石UI。此功能以前包含在“最小主题”中，但现在已被分离出来。 设定值 口音颜色 控制重点色相和饱和度。 此颜色用于交互式元素，例如链接，按钮，文本选择等。 可以打开或关闭花式光标，以使编辑器光标使用强调色。 背景颜色 有几种选项可用于亮模式和暗模式。 这些选项可以通过可定制的热键进行切换。 默认情况下，侧边栏使用稍微深一点的背景 低对比度将侧边栏和主面板使用相同的背景 高对比度（仅在灯光模式下）使用深色侧边栏和灯光主面板 真黑色（仅深色模式）使用纯黑色边栏和主面板 编辑器和Monocode字体 系统字体 （必须单
Markdown基础语法
一个专注于机器学习基础与实战的技术博客，内容涵盖算法推导、模型实现、数学原理与代码实践。用通俗的语言解析复杂概念，记录学习过程中的思考与总结，适合机器学习爱好者和从业者参考。
01-14 3268
文章目录Markdown语法1、Markdown标题2、Markdown段落3、Markdown字体4、Markdown分隔线5、Markdown删除线6、Markdown下划线7、Markdown脚注8、Markdown列表9、Markdown区块区块和列表的组合使用10、Markdown代码代码区块11、Markdown链接高级链接12、Markdown图片13、Markdown表格14、Markdown高级技巧15、公式16、流程图的绘制17、生成目录的方法 Markdown语法 1、Markdown
md(Markdown)文件基础语法
热门推荐
吴名氏的博客
10-30 5万+
md(Markdown)文件基础语法
md语法入门
fighting__hg的博客
04-08 1059
Markdown语法标题书写 #一级标题 ##二级标题 ###三级标题······ 列表书写 无序列表： *无序列表 有序列表： 1.有序列表 2.有序列表······ 引用 引用： >引用内容 >>引用中的引用 图片与连接*! [图片] (地址) * [链接名] (地址) 百度粗体和斜体 粗体：* 粗体内容 * 斜体：* 斜体内容 * 表格 ABCD EFGH
MD语法笔记
weixin_56028738的博客
03-12 547
MD语法笔记 表格序号34 标题 在Markdown中，如果想将一段文字定义为标题，只需要在这段文字前面加上 #，再在 # 后加一个空格即可。还可增加总共六级的标题，只需要增加 # ，标题字号就会相应降低一级。 # 一级标题 ## 二级标题 ### 三级标题 一级标题 二级标题 三级标题 列表 在文字前加-和空格即可制作列表 - 1：列表一 - 2：列表二 - 列表2.1 - 3：列表三 1：列表一 2：列表二 列表2.1 3：列表三 引用 在文本前面加>来制作
.md(markdown)基础语法
didi8969的博客
10-10 169
.md(markdown)基础语法 markdown基础语法笔记，方便翻看。 1. 标题 标题有3中写法，可混写： （1）# ***，前面#，后面文字，注意，#与文字间有空格，1-6个#分别表示h1-h6，h1、h2下有横线 （2）==== 或 ----...
Markdown（MD）笔记的详细介绍
ywddxfs的博客
10-12 1923
Markdown笔记使用的详细说明
Markdown最详细的语法教程，.md文件解读
qq_59572239的博客
02-05 7190
markdown语法的详细介绍和使用方法 看这一篇文章就够了！
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值