Markdown

推荐的文档结构：

# 文档标题： 同文件名
作者
摘要
目录
## 标题1
### 标题1.1
## 标题2
.。。

这应该算是传统的markdown 文档结构，但是为了适应工具要求，比如hope主题 在fronmatter 中设置作者，摘要标签前所有信息均为摘要 等，可以适当调整结构。这里从2级标签开始划分文档，我之前都是从1级开始，1级前作为文档说明。

代码块

demo

#include <iostream>

int main()
{
	int i;
	int i = 3;
	
	std::cout << "hello" << std::endl;
	int *p = new int(3);
	auto j = i / 0;
	//Word highlight
	Word
	
	//从这里开始折叠折叠
	:collapsed-lines = 17
	auto func = []() {
		std::cout << "lambda";
	}
	
	return 0;
	
}

行号	功能	语法	配置属性
5、6	差异	[!code --], [!code ++]	notationDiff
8	行高亮	[!code highlight]	notationHighlight
9、10	错误标记	[!code warning], [!code error]	notationErrorLevel
12、13	字符高亮	[!code word:Word]	notationWordHighlight
16	折叠	:collapsed-lines :no-collapsed-lines :collapsed-lines=17 //从17行开始换行	collapsedLines
	标题	``` cpp title="demo"

问题：

1. 标题是不支持中文吗？;
2. 标题设置总是报错：
   
   我的原文：
   
   编译为html 失败的原因是我多打了\” ？
   查看二进制文件信息
   
   \“ 的值是0x22，0x0A 是换行，没有多打
   搞不懂。。。
   发现原因了

设置代码块的标题时需要指定语言
使用txt title="frontmatter" 编译输出正常；
使用 ``` title="frontmatter" 编译失败，
title 和前面的` 没有间隔，也会编译失败

。。。所以是obsidian 太强大了吗，在ob中都是正常的

配置：

theme.ts

hopetheme({
	//...
	markdown: {
		highlighter: {
			notationDiff: true,
			notationHighlight: true,
			notationErrorLevel: true,
			notationWordHighlight: true,
			notationFocus: true,
			collapsedLines: true,
		},
	},
)}

聚焦

console.log(`1`);
console.debug(`2`); 
console.log(`3`);

行号	功能	语法	配置属性
2	聚焦	[!code focus]	notationFocus

GFM 警告

具有图标、背景颜色，用来突出显示信息的块
配置：

theme.ts

markdown: {
	...
	alert: true,
	...
},

示例:
note，vuepress 中除了提示标题，还需要有内容才会呈现效果，否则只会显示文字内容。obsidian中可以不包含内容直接显示标题。

[!note]

Demo

>[!note]

支持的类型：

重要

important

相关信息

info

Demo

>[!info]
>info

提示

tip

注意

warning

警告

caution

问：不支持quote，该如何添加支持类型？

每行都要以 > 开始，否则内容不会被包围

注意

必须以>起始

ob中能够正常显示

Demo

每行都要以 > 开始，否则内容不会被包围
>[!warning]
必须以>起始

ob中能够正常显示

选项卡

多个卡片放置在一起，通过标题切换卡片

配置：默认开启

themt.ts

markdown: {
	tabs: true,
},

示例：
选项卡组1

开始

begin

结束

end

选项卡组2

begin

开始

end

结束

选项卡语法

选项卡组1
::: tabs#fruit
@tab 开始 #1
begin
@tab:active 结束 #2
end
:::

选项卡组2
::: tabs#fruit
@tab begin #1
开始
@tab:active end #2
结束
:::

1. 创建容器：::: tabs, tabs 前有空格，::: 容器结束标志
2. 创建选项卡：@tab
3. 卡片标题：@tab 后设置标题
4. 卡片内容：到下一个选项卡之间的内容就是当前卡片内容
5. 容器id：在tabs 后使用 #card，设置id 为card
6. tab值：在tab 后使用#1，设置tab 值为1
7. 默认tab：@tab:active
8. 多个卡组同步切换（卡组1从标题1切换到标题2，卡组2同步切换到2）
   1. 两个卡组的id 相同
   2. 卡组内tab 的值相同

预览

展示显示效果，折叠代码实现
配置：

theme.ts

export default hopeTheme({
  markdown: {
    preview: true,
  },
});

示例

\::: preview 可选标题
内容
\:::

可选标题

``` txt
\::: preview 可选标题
内容
\:::
```

。。。问题：在代码块中的::: 会匹配到代码块外的:::

问：如何设置折叠状态？

未归档

表格：表格内换行 使用<br>

BUG?

文档内容空白
发现：文档 “关于报文格式的说明” 网页显示文章内容空白
通过逐步删除内容排查到问题产生点：表格中 使用了“{DPI，...}”
解决：在... 前增加转义符号\ 文章内容正常显示。
后续测试，出现以下内容会导致文档内容显示空白

{,...}

表格内放置图片
如果直接将图片粘贴到表格内没有显示，但有的时候好像又可以显示。。。

先将图片粘贴到表格外的空白处，添加标题，然后再贴到表格内，似乎是行得通。

html table
标签之间不能空行？

<table>
	<tbody>
		<td> hello </td>
		
	</tbody>
</table>

|300x139

obsidian 中能正常显示