markdown 基础语法

使用VScode时的一些意外情况

最开始用的是vscode写md笔记，但是最后需要用它写代码，所以就去用其他的编辑器了，寻找过程一言难尽，因为我觉得大部分md编辑器都比不上vscode，不过最后终于找到了比vscode强大的笔记了——obsidian

下面是一些刚刚开始用vscode写笔记的一些意外情况：

隐藏了菜单栏

点击 VScode 最顶端的空白处，按 F1 切换出命令行，输入 menu，回车。

隐藏了侧边栏（状态栏，活动栏同理）

查看->外观->显示侧边栏

快捷键

文件->首选项->键盘快捷方式

编辑与预览不对齐

可能是你收起了一些内容，将其展开即可

一直报错

严格遵守 markdown 语法规范（自己去搜吧，，，）
（没办法，vscode检查语法规范的插件太厉害了，但也不方便直接禁用它，因为还要写代码嘞）

段落

这是一个段落（若要换段落就点两次换行）

这是一行字
这是另一行字
（在一行字的后面加两个空格，然后换行，就可以写另一行字）
（这样得到的是一行行字，其行间距较小，行与行堆在一起会组成段落，段落之间的行间距较大）

上面的解释是对于某些语法比较严格的md编辑器，如果你的主力编辑器语法比较松，且不考虑该md的可移植性（copy到其他md编辑器）的话，就自由发挥吧

标题

eg：

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

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

注意：

最多有六级标题。
另一种标题的方式：加等号和减号的，在此处提一下以作了解，不举例，因为比较难用，我自己几乎不会用到

分割线

三个*或三个-

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

文字颜色

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

表格

eg：

	1	2	3
1	（1，1）	（1，2）	（1，3）
2	（2，1）	（2，2）	（2，3）
3	1	1	1

tips_1_对齐

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

	1	2	3
1	（1，1）	（1，2）	（1，3）
2	（2，1）	（2，2）	（2，3）
3	1	1	1

tips_2_表格中有竖线

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

目前发现兼容性较好的一种就是：

功能	获取共享内存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

tips_3_在表格中换行

CSDN的编辑器和我用的obsidian的渲染的有些不一样，这里表格默认居中对齐，所以我的空格和换行不是很明显

用<br>，这玩意不仅仅在表格中可以用，在正文里面也行，但如此一来然并卵
（看的有些地方说的要加<br/>，但是obsidian不能加斜杠，应该是obsidian对兼容性做出了调整，毕竟obsidian多多少少必须带一点富文本属性以更加人性化）

111111
111111111111
111111
11111111

功能	设置分离属性到属性变量里
头文件	`#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`使用

空格

在用表格的时候学到的，一个字节的空格：，两个字节的空格：

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

111111111111111111111111
111111111111111111111111
111111111111111111111111
我我我我我我我我我我我我
我我我我我我我我我我我我
我我我我我我我我我我我我

可以看到，在CSDN的编辑器成功了

无序列表

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

A
B(下面的C与D是嵌套进B的)
- C
- D

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

换行后会默认给你加上 -，空格也给你加上了。切换级别的话，上一级换行后直接按 tab 即可(有序列表同理）

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

A
B
- C
- D

obsidain的这种样式的多序列表应该和待办清单联系起来了，那个删除线好评

有序列表

A
1. C
2. D
B
1. C
2. D

注解

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

应用

d

又：

d
d

又：

d

d

注意：

注解的换行方式跟普通文字的换行一致
其他 markdown 编辑器，比如纯纯写作，换行方式可能与 VScode 有所区别,有时候也取决于预览功能的不同
（这里的换行方式，主要针对的是需不需要空一行，以及注释的自动合并）

引用的嵌套

A

B

C
H

D

E

F

G

文字格式

斜体

斜体
斜体

粗体

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

例：大帅批

斜体和粗体同时运用

斜体和粗体同时运用

删除

高亮

高亮

注意：这个符号就是英文的反引号，位于键盘的 Esc 下方。

代码

单行代码：
printf("hello world!);

实际上就是高亮显示

代码块
这里需要使用printf函数

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

链接

https://www.bilibili.com/

图片

本地图片

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-ZEGNffwt-1667309888663)(./images/img1.jpg)]

注意：

括号内要写的是图片名称以及图片格式 .jpg
本地图片储存的位置，
VScode 默认读取的是目前 md 文件所保存的文件夹内，当然，若是图片位置不对头，自己可以在图片名称前加上相应位置
.jpg 是不能少的，名称前可以写./也可以省略，若图片格式不是 .jpg 则需改正图片格式
不出意外的话，上面那张图片，没被我误删的话，除了在本电脑上打开此 md 文件，能看到外，在其他端都看不见，而后续的图片我都存在图床上，故而在其他端打开也能看见。

picgo+gitee=图床

此图片与上面的本地图片是一张图，只不过一个是储存在本地，一个是上传到了图床里。
要说明一下，欲构造 picgo 图床，如果想用免费gitee仓库作为储存图片的方式的话，不可避免地需要选择其中的插件，但是，在 picgo 中安装 gitee 插件必须要在配置好 nodejs 的状况下，按照 CSDN 上的教程，有一定的几率不会碰到问题一把过，但一旦出了问题，只能说非常麻烦，就好比我第一次安装和第二次安装，到最后下包时，都出现了成片的 npm ERROE，就比如：
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-UtyjDC4o-1667309888665)(https://fhzy886.oss-cn-hangzhou.aliyuncs.com/images/5f91fbfdc4ca80b9b705a2cb226b2c0.jpg)]

这大概率是代表 nodejs 的安装目录没有写入权限，这时候，在对应的安装目录上单击右键–>属性–>安全–>编辑–>勾选写入权限–>确定即可。
相关的操请参考：https://www.bilibili.com/video/BV1t3411Y78i

只能说很坑，因为在 CSDN 上我查找了很久，都没有找到这个问题，可能大神都不愿意说这种幼稚的问题吧。

另外，在构建图床的时候，
在最后一步卡了很久，一直报错：

2022-01-30 19:54:48 [PicGo ERROR]
------Error Stack Begin------
Error: image not found in clipboardat PicGo.upload (D:\Users\25308\AppData\Local\Programs\PicGo\resources\app.asar\node_modules\picgo\dist\src\core\PicGo.js:180:27)at processTicksAndRejections (internal/process/task_queues.js:89:5)at async Object.upload (D:\Users\25308\AppData\Local\Programs\PicGo\resources\app.asar\background.js:36:29196)at async Bt (D:\Users\25308\AppData\Local\Programs\PicGo\resources\app.asar\background.js:36:30882)
-------Error Stack End-------

到最后发现，
我是被之前收到的教程坑了。

因为网上的教程都是已经调试好了的，
都没有提到最后一步，
也就是选择图床，

对于我的picgo+gitee，
也就是在这个倒三角下方的 gitee 这里进行勾选

还有，上传到 picgo 里面的图片名称不能有中文，或者说，需要保证最后生成的链接里面不能有中文，不然到最后，链接的图片无法被正常使用

and ，通过 QQ 传到电脑上的图片，最后生成的链接不可用，在 picgo 上可上传但无法查看，但 gitee 上可上传可查看，所以，需要用到 picgo 的图片尽量用微信文件传输助手传输。

还需要说明一下，免费的就是最贵的，尽量采用付费的 OSS 来储存，不要贪小便宜，不然可能会因为当初的贪小便宜而让自己因为数据存储被迫付出更大而代价

比如gitee的防盗锁，当时真的让人头疼

编辑器的推荐

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

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

VScode 具有极其强大的插件功能，通过网上搜索教程来调教 VS，完全可以轻松实现 markdown 编写的需求。
而 gitee 与 picgo 的组合，更是与免费与快速的完美结合（毕竟是免费的）
坚果云是用来同步/保存本地内容的，也可以轻松实现三端互通，作为主力的私人云盘，即使是免费版也能基本满足需求，而且，也能在 Android 与 iOS 端用坚果云自带的查阅功能查看 md 笔记。
最后要提到的就是纯纯写作了，在本组合中，作为 VScode 的 Android 端替代品，体验很不错，当然，主要是我入正了哈哈哈哈，但是需要导入进去建立新文章才能看，所以我平时偷懒一般直接用坚果云直接查阅，那体验简直不如纯纯的十分之一。

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

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

obsidain是神器，插件和主题很多，所以可玩性很高，优点是一定可以找到最适合自己的md写作状态，缺点也是这样，你在适应之前会花费一段时间来学习如何使用obsidian，不然按照默认的配置使用体验只能算马马虎虎
阿里云OSS：付费，也需要配置，但不算贵而且教程很多，使用起来比gitee好，而且最重要的是数据安全有保证
picgo：用的不是gitee图床，所以压根不用配置环境

markdown 语言规范

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

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

picgo

千万不要随便删除 picgo 相册里的照片，不然这就是后果（因为里面有默认同步删除仓库里的图片的选项，，，，，，）

1.markdown基础语法相关推荐

小白的markdown基础语法总结
markdown基础语法使用markdown写博客也有一段时间了,现在对我使用到的一下语法作个总结. 其他语法以后用到再进行补充~ 文章目录 markdown基础语法生成目录各级标题 1级 2级 ...
MarkDown 基础语法速成初级篇
MarkDown 基础语法半天速成篇名词解释: MD-MarkDown是一种非常轻量级的标记语言,它允许人们使用易读易写的纯文本格式编写文档, 编写后的文本可以导出为html,word,图像,pdf ...
Markdown基础语法的学习
Markdown基础语法 Markdown可以在任何地方使用,而且可以被任何系统的任何文本编辑工具打开,十分简便.同时程序员的世界更离不开它,GitHub.简书.csdn等都支持,而且官方技术文档都是 ...
markdown基础语法的使用
title: markdown基础语法的使用一.快捷键 (1)对文字的特殊标注标题一个#键就是一级标题,一直可到六级标题(最多六个级别的标题) 下划线一组标签可以给文字添加下划线或者ctrl+ ...
Markdown 基础语法与常见问题总结
最近在用 Markdown编辑SCI科技论文的初稿, 所以在此记录一些win10使用Markdown pad2时遇到的问题与基础语法: 1. //半角空格(英文) 2. //全角空格(中文) 3.句末 ...
Markdown基础语法教程
目录 Markdown介绍 Markdown优缺点优点缺点 Markdown主要场景 Markdown基本语法标题列表引用脚注高亮斜体和粗体以及粗斜体删除线(中划线) 分隔线复选框 ...
Markdown基础语法小结
一.前言 Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式. --摘自百度百科没想到一向不太靠谱的百度百科这次竟有了如此精辟的解释. ...
MarkDown基础语法记录
基础语法记录,其中有一些博客园暂不支持 # 一级标题 ### 二级标题### 三级标题#### 四级标题##### 五级标题###### 六级标题一级标题二级标题三 ...
Typora资源和Markdown基础语法
本章内容如下: Typoar笔记下载资源及主题设置 Markdown语法使用的基本方法这篇博客一开始是为了教女朋友如何使用Typora和Markdown语法写的笔记,Markdown语法的内容不太全 ...

1.markdown基础语法