【md】1.markdown基础语法

已于 2023-04-08 23:22:24 修改
阅读量5.2k 收藏 28
点赞数 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主要是在电脑上使用的
fh_zy
关注
  • 6
    点赞
  • 踩
  • 28
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
专栏目录
obsidian修改了的主题和常用的插件
08-30
自己摸索的修改的主题，和下载的常用的插件，用obsidian打开这文件夹相应的设置就可以直接用了。
推荐一款开源的 Obsidian 颜色方案
最新发布
gitblog_00073的博客
03-14 485
推荐一款开源的 Obsidian 颜色方案 如果你在使用 Obsidian 进行笔记管理，那么这款颜色方案可能会让你的工作更加高效、愉快。 项目简介 mekwall/obsidian-color-scheme 是一款由 mekwall 开发的开源 Obsidian 颜色方案。它提供了多种配色风格供用户选择，包括深色模式和浅色模式，可以满足不同用户的需求。 应用场景 笔记管理：Obsidian 是...
obsidian-vars
03-21
黑曜石样本插件 这是Obsidian（ ）的示例插件。 该项目使用Typescript提供类型检查和文档。存储库取决于Typescript Definition格式的最新插件API（obsidian.d.ts），其中包含描述其功能的TSDoc注释。 注意：黑曜石API仍处于早期Alpha状态，随时可能更改！ 该示例插件演示了插件API可以执行的一些基本功能。 使用styles.css将默认字体颜色更改为红色。 添加一个功能区图标，单击该图标将显示一个通知。 添加一个命令“ Open Sample Modal”，以打开一个模态。 将插件设置选项卡添加到设置页面。 注册一个全局单击事件，并将“单击”输出到控制台。 注册一个全局间隔，将“ setInterval”记录到控制台。 第一次开发插件？ 新插件开发者快速入门指南： 使用“使用此模板”按钮（使用此模板，请登录GitHub）将其作为模板复
OBSidian OBSidian
08-17
OBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidianOBSidian
obsidian-kanban
04-16
黑曜石样本插件 这是Obsidian（ ）的示例插件。 该项目使用Typescript提供类型检查和文档。 存储库取决于Typescript Definition格式的最新插件API（obsidian.d.ts），其中包含描述其功能的TSDoc注释。 注意：黑曜石API仍处于早期测试阶段，随时可能更改！ 该示例插件演示了插件API可以执行的一些基本功能。 使用styles.css将默认字体颜色更改为红色。 添加一个功能区图标，单击该图标将显示一个通知。 添加一个命令“ Open Sample Modal”，以打开一个模态。 将插件设置选项卡添加到设置页面。 注册一个全局单击事件，并将“单击”输出到控制台。 注册一个全局间隔，将“ setInterval”记录到控制台。 第一次开发插件？ 新插件开发者快速入门指南： 使用“使用此模板”按钮（使用此模板，请登录GitHu
.md即markdown文件常用语法
tang31415926的博客
05-07 4297
markdown的基础使用方法
Markdown基础语法详细版
jd1813346972的博客
04-22 4477
主要聚焦讲解Markdown基础语法
[笔记.Markdown]基本语法及常见用法示例
:: Dotnet Fantasy ::
02-02 592
Markdown基本语法及常见用法示例
markdown基本语法.md
qq_39852145的博客
10-08 742
文章目录一、基本用法1.目录1.1 TOC1.2 doctoc 和i5ting_toc2.标题2.1使用`=`和`-`标记一级和二级标题。一级标题二级标题2.2使用`#`，可表示1-6级标题。一级标题二级标题三级标题四级标题五级标题六级标题3.段落3.1普通段落3.2 代码区块4.代码4.1 单行代码4.2 多行代码5.区块引用及嵌套6.强调7.锚点和页内跳转7.1markdown的方法：7.2h...
obsidian-minimal-settings:设置插件，用于控制“最小主题”中的颜色和字体
05-24
概述 此插件随附，使您可以从“黑曜石设置”面板自定义主题。 使用最小主题不需要此插件，但强烈建议使用。 在 ， 或“上支持我的插件和主题@kepano的开发。 用法 要求最低主题2.0.0最低 “最小主题”与“一起使用，通过删除菜单功能区，工具提示，标题栏，滚动条等来简化黑曜石UI。此功能以前包含在“最小主题”中，但现在已被分离出来。 设定值 口音颜色 控制重点色相和饱和度。 此颜色用于交互式元素，例如链接，按钮，文本选择等。 可以打开或关闭花式光标，以使编辑器光标使用强调色。 背景颜色 有几种选项可用于亮模式和暗模式。 这些选项可以通过可定制的热键进行切换。 默认情况下，侧边栏使用稍微深一点的背景 低对比度将侧边栏和主面板使用相同的背景 高对比度（仅在灯光模式下）使用深色侧边栏和灯光主面板 真黑色（仅深色模式）使用纯黑色边栏和主面板 编辑器和Monocode字体 系统字体 （必须单
Typora-Markdown基础语法学习.md
09-04
关于Markdown常用语法的简单介绍
markdown基础语法.md
08-23
markdown语法简介
MarkDown基础语法使用.md
04-16
个人学习，不建议下载
MarkDown语法.md
09-07
MarkDown基础语法
md基础语法总结.md
11-26
在Typora编辑markdown文档的基本语法
Obsidian配置
m0_46161993的博客
09-13 2878
使状态栏平铺显示、调整markdown显示使其文字两端对齐、增加预览窗口大小、markdown图片默认居中显示、增加全屏状态下的文字宽度即调整页边距。和对应的Obsidian默认主题的所有可修改文件的css，这个css可以在插件的GitHub上找到。配合obsidian默认的ccs使用更改字体颜色的。该插件readme文档提供了默认的ccs文件。用正则表达式隐藏文件夹的，我的设置隐藏以。）到当前位置（光标处）所有模板设置放在。可以根据模板文件生成新的文件（），也可以插入模板（
Obsidian学习日志
qq_16479519的博客
05-05 680
本文旨在介绍详细的各个选项去学习使用obsidian，作者也只是一个想学会使用ob的小白。
obsidian保存文件
04-03
Obsidian存储文件的方式与其他文本编辑应用程序非常相似。以下是保存Obsidian文件的步骤： 1. 在编辑器中打开您想要保存的Obsidian文件。 2. 点击编辑器左上角的保存按钮（类似于其他应用程序中的文件保存按钮）。 3. 如果您是第一次保存文件，则会提示您输入文件名和保存位置。在此处，您可以选择将文件保存在本地计算机上的任何位置。 4. 如果您已经保存了文件，则只需单击保存按钮即可将更改保存到现有文件中。 5. 您还可以使用快捷键Ctrl + S（Windows）或Command + S（Mac）来保存文件，这将更快地保存您的更改。 请注意，Obsidian保存的文件是纯文本文件，因此它们使用的扩展名通常是.md（Markdown）或.txt（文本文件）。您可以在Obsidian中创建文件夹和子文件夹来组织您的文档。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值