【md】1.markdown基础语法

article/2025/10/12 8:58:53

一、基本文本使用

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

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. A1. C2. 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主要是在电脑上使用的

http://chatgpt.dhexx.cn/article/CTrQfVKD.shtml

相关文章

.MD语法

.MD语法

.md即markdown文件的基本常用编写语法,是一种快速标记、快速排版语言&#xff0c;现在很多前段项目中的说明文件readme等都是用.md文件编写的&#xff0c;而且很多企业也在在鼓励使用这种编辑方式&#xff0c;特别作为一个前端从业者更要学会使用这种语言。下面就简单和大家分享…
阅读更多...
md文档语法大全

md文档语法大全

目录 基本符号 标题 # 文字 # 文字 # 列表 无序列表 有序列表 嵌套列表 引用块 行引用 嵌套引用 代码块 链接 图片 分割线 表格 复选框 换行 其他 基础不牢&#xff0c;地动山摇&#xff0c;好的文档是项目质量及后续可维护的一个重要因素&#xff0c;每次…
阅读更多...
PHPRunner 10.7.0 PHP代码生成器

PHPRunner 10.7.0 PHP代码生成器

PHPRunner 10.7.0 PHP代码生成器。 使用 PHPRunner 构建现代、功能丰富、响应迅速、数据驱动的 Web 应用程序。连接到 MySQL、SQL Server、MS Access 和 Oracle。这种快速的应用程序开发/低代码软件将使您的交付速度提高多达 90% - 它对于初学者来说很容易使用&#xff0c;但对…
阅读更多...
generate-code开源的代码生成器（FlierTeam）

generate-code开源的代码生成器（FlierTeam）

generate-code开源的代码生成器 一、背景二、项目链接三、功能介绍&#xff08;一&#xff09;通用代码生成器代码生成切换数据源下载 &#xff08;二&#xff09;可修改模板的生成器模板管理 四、总结 一、背景 从开源项目&#xff1a;https://gitee.com/QinHaiSenLin/Jfinal…
阅读更多...
5.6 Mybatis代码生成器Mybatis Generator (MBG)实战详解

5.6 Mybatis代码生成器Mybatis Generator (MBG)实战详解

文章目录 前言一、Mybatis Generator简介二、Maven插件运行方式三、生成配置 generatorConfig.xmlMyBatis3Simple风格MyBatis3风格MyBatis3DynamicSql风格 四、Java代码运行方式五、MGB生成全部表六、增加Ext包七、Git提交总结 前言 本文我们主要实战Mybatis官方的代码生成器&…
阅读更多...
软著代码生成器

软著代码生成器

软著代码生成器 介绍使用说明 使用下载 介绍 软著代码生成器 自动生成word 自动删除注释单行注释(python c# 等)每页50行代码自动删除空行 使用说明 下载解压即可使用 使用 下载 gitee下载地址 觉得好用的客官, 欢迎star
阅读更多...
mybatis代码生成器

mybatis代码生成器

mybatis代码生成器 步骤一&#xff1a;在pom中安装mybatis generator 自动生成代码插件 步骤二&#xff1a;复制代码生成器代码&#xff0c;修改数据库配置&#xff0c;及实体类生成的位置即可 步骤三&#xff1a;增加配置启动命令 步骤一&#xff1a;在pom中安装mybatis gener…
阅读更多...
C# 源代码生成器

C# 源代码生成器

C# 源代码生成器 什么是源生成器源生成器允许执行两个主要操作Microsoft 文档模型图示常见方案源生成器的使用1、创建 .NET控制台应用程序2、创建源生成器项目3、在控制台程序中使用生成器项目 结语 什么是源生成器 源生成器是由.NET Compiler Platform&#xff08;“Roslyn”&…
阅读更多...
vue代码生成器

vue代码生成器

直接根据swagger api生成vue代码 前要 目前的代码生成器基本上是基于数据库表格来生成对应的前后台代码&#xff0c;好处是前后台一次性搞定&#xff0e;但实际开发中&#xff0c;很多的业务是需要连表的&#xff0c;所以这种情况来说&#xff0c;根据接口直接生成前代码&#…
阅读更多...
C#代码生成器

C#代码生成器

引言 引言&#xff1a;随着.net Core 的不断发展&#xff0c;它也是一个成熟的平台了&#xff0c;鲁迅说过&#xff1a;成熟的平台就要学会自己写代码&#xff0c;那么今天我就在这里教大家如何让.net Core学会自己写代码。 提示&#xff1a;如果只是向往&#xff0c;远方依旧…
阅读更多...
MybatisPlus代码生成器

MybatisPlus代码生成器

代码生成器 问题导入 如果只给一张表的字段信息&#xff0c;能够推演出Domain、Dao层的代码&#xff1f; 1. MyBatisPlus提供模板 Mapper接口模板 实体对象类模板 2. 工程搭建和基本代码编写 第一步&#xff1a;创建SpringBoot工程&#xff0c;添加代码生成器相关依赖&…
阅读更多...
python 代码生成器_Python代码生成器(代码生成工具)V1.1 正式版

python 代码生成器_Python代码生成器(代码生成工具)V1.1 正式版

Python代码生成器(代码生成工具)是一款很优秀好用的为新手制作的代码生成助手。小编带来的这款Python代码生成器功能强大&#xff0c;操作简单&#xff0c;使用后可以帮助用户更轻松便捷的生成Python代码&#xff0c;非常方便实用。其内置了大量的示例代码&#xff0c;可以帮助…
阅读更多...
12款AI代码生成工具，都很能打

12款AI代码生成工具，都很能打

1.Anania Anania 是一个机器人数据分析师&#xff0c;可以通过简单、自然的英语对话来分析您的数据。连接数据源并以简单的英语提问&#xff0c;无需任何设置或配置。在幕后&#xff0c;Anania 正在使用一个 AI 系统&#xff0c;该系统将文本转换为 SQL 和 Python 代码并执行您…
阅读更多...
3D相册动态桌面制作

3D相册动态桌面制作

3D相册动态桌面制作 1.下载3D相册代码链接&#xff1a;https://pan.baidu.com/s/1Z_br3XKGsW3vsISvSCteJA&#xff0c;提取码&#xff1a;8888 更换自己喜欢的图片 注意第三张和第四章相册右键旋转照片 直接双击运行index.html可以在浏览器中看到效果。 如果不是很喜欢 可以自行…
阅读更多...
HTML+CSS+JavaScript七夕情人节表白网页【樱花雨3D相册】超好看

HTML+CSS+JavaScript七夕情人节表白网页【樱花雨3D相册】超好看

这是程序员表白系列中的100款网站表白之一&#xff0c;旨在让任何人都能使用并创建自己的表白网站给心爱的人看。 此波共有100个表白网站&#xff0c;可以任意修改和使用&#xff0c;很多人会希望向心爱的男孩女孩告白&#xff0c;生性腼腆的人即使那个TA站在眼前都不敢向前表白…
阅读更多...
制作简易的3D相册

制作简易的3D相册

今天介绍一下3D相册&#xff0c;用到了开源的FeatureCoverFlow控件&#xff0c;之前的几个作品用的也全都是开源的控件&#xff0c;为什么要用开源的控件呢&#xff0c;因为...他稳定啊&#xff01; 1.准备 仍然是&#xff0c;去掉标题栏&#xff0c;然后导库&#xff1a; impl…
阅读更多...
HTML5、css3、js实现3D相册

HTML5、css3、js实现3D相册

目录 想法 实现 一、基础知识 1.3D转换 transform-style: preserve-3d; ①简述 ②使用 ③3D转换方法 2.onmouseover 事件 ①解释 ②具体语法 3.onmouseout事件 ①解释 ②具体语法 **本例通过在div的class中设置相同的类名&#xff0c;然后在js方法中通过document…
阅读更多...
前端CSS3实现3D相册小案例

前端CSS3实现3D相册小案例

前端CSS3实现3D相册小案例 HTML代码部分&#xff1a; <!DOCTYPE html> <html lang"en"> <head> <meta charset"UTF-8"> <title>3D相册</title> <link type"text/css" href"css/style.css&qu…
阅读更多...
制作一个简单3D相册

制作一个简单3D相册

- 用到的点&#xff1a; 旋转 2D 旋转 transform: rotate(值deg) deg 角度的单位 3D 旋转 transform:rotateX rotateY roteteZ 如果让一个块实现3D效果&#xff0c;必须做两件事&#xff1a; 1、在要实现3D效果的块上 加transform-style:preserve-3D (声明) 2、在要实现3D效…
阅读更多...
html结合css实现浏览器展示3D相册

html结合css实现浏览器展示3D相册

最近写了一个在浏览器展示3D相册效果&#xff0c;通过html文件结合css实现。 1.html详细代码如下&#xff1a; <!DOCTYPE html> <html> <head> <meta charset"UTF-8"> <title>3D相册</title> <script src"../js/jquer…
阅读更多...
推荐文章

Copyright @ 2022~2023