Obsidian 插件:Table Extended
插件名片
概述
非可视化操作表格,但因为表格增加了新扩展,能够支持单元格合并等效果,但是需要你熟悉下新的语法格式
原文出处
下面自述文件的来源于 Readme
Readme(翻译)
下面是 table-extended 插件的自述翻译
扩展表格
使用 MultiMarkdown 表格语法扩展 Obsidian 中的基本表格。
简介
Obsidian 的 内置表格语法 只能定义表格的基本内容。当用户尝试应用具有 colspan
或多个表头的复杂表格时,他们唯一的选择是回退到原始的 HTML,这样很难阅读和编辑。
该插件将 MultiMarkdown 表格语法 引入到 Obsidian 中,它提供了以下功能,并保持内部链接和嵌入的完整性:
已知问题
- 此插件尚不与 Advanced Tables 兼容,因为其自动格式化会破坏 mmd6 表格语法。
- 带有“-tx-”的表格有时会忽略转义字符,例如,
\|
无法在表格中转义|
,只有\\|
有效。 - 扩展的原生语法有时可能无法正常工作,控制台输出为:“无法获取 Markdown 文本,正在转义…”
如何使用
最新版本使用了一种新的语法来表示扩展表格,以取代围栏式的 tx
代码块,这样可以更好地支持反向链接和前向链接,在表格之前使用 -tx-
前缀:
PS:对于实验性的扩展原生语法支持,可以在 这里 查看。
-tx-
| | Grouping ||
First Header | Second Header | Third Header |
------------ | :-----------: | -----------: |
Content | *Long Cell* ||
Content | **Cell** | Cell |
New section | More | Data |
And more | With an escaped '\|' ||
[Prototype table]
将被渲染为:
Grouping | ||
---|---|---|
First Header | Second Header | Third Header |
Content | Long Cell | |
Content | Cell | Cell |
New section | More | Data |
And more | With an escaped '|' |
有关更详细的指南,请查看 markdown-it-multimd-table README 和 MultiMarkdown User’s Guide
实验性:扩展原生语法
注意:以下功能不受支持:
当在设置选项卡中启用该选项时,Obsidian 的常规表格允许使用扩展语法:
下面的表格:
First Header | Second Header | Third Header |
------------ | :-----------: | -----------: |
Content | *Long Cell* ||
Content | **Cell** | Cell |
New section | More | Data |
And more | With an escaped '\|' ||
将被渲染为:
First Header | Second Header | Third Header |
---|---|---|
Content | Long Cell | |
Content | Cell | Cell |
New section | More | Data |
And more | With an escaped '|' |
多行
末尾的反斜杠与下面的行内容合并。
| Markdown | Rendered HTML |
|--------------|---------------|
| *Italic* | *Italic* | \
| | |
| - Item 1 | - Item 1 | \
| - Item 2 | - Item 2 |
| ```python | ```python \
| .1 + .2 | .1 + .2 \
| ``` | ``` |
解析如下:
Markdown | Rendered HTML |
---|---|
|
Italic |
|
|
|
|
跨行合并
^^
表示上方合并的单元格。
阶段 | 直接产物 | ATP产量
----: | --------------: | ---------:
糖酵解 | 2 ATP ||
^^ | 2 NADH | 3--5 ATP |
丙酮酸氧化 | 2 NADH | 5 ATP |
柠檬酸循环 | 2 ATP ||
^^ | 6 NADH | 15 ATP |
^^ | 2 FADH2 | 3 ATP |
**30--32** ATP |||
解析如下:
阶段 | 直接产物 | ATP产量 |
---|---|---|
糖酵解 | 2 ATP | |
2 NADH | 3–5 ATP | |
丙酮酸氧化 | 2 NADH | 5 ATP |
柠檬酸循环 | 2 ATP | |
6 NADH | 15 ATP | |
2 FADH2 | 3 ATP | |
30–32 ATP |
多行标题
| | 分组 ||
第一列标题 | 第二列标题 | 第三列标题 |
------------ | :-----------: | -----------: |
内容 | *长单元格* ||
渲染为:
分组 | ||
---|---|---|
第一列标题 | 第二列标题 | 第三列标题 |
内容 | 长单元格 |
无表头
表头可以被省略。
|--|--|--|--|--|--|--|--|
|♜| |♝|♛|♚|♝|♞|♜|
| |♟|♟|♟| |♟|♟|♟|
|♟| |♞| | | | | |
| |♗| | |♟| | | |
| | | | |♙| | | |
| | | | | |♘| | |
|♙|♙|♙|♙| |♙|♙|♙|
|♖|♘|♗|♕|♔| | |♖|
解析如下:
♜ | ♝ | ♛ | ♚ | ♝ | ♞ | ♜ | |
♟ | ♟ | ♟ | ♟ | ♟ | ♟ | ||
♟ | ♞ | ||||||
♗ | ♟ | ||||||
♙ | |||||||
♘ | |||||||
♙ | ♙ | ♙ | ♙ | ♙ | ♙ | ♙ | |
♖ | ♘ | ♗ | ♕ | ♔ | ♖ |
兼容性
所需的 API 功能仅适用于 Obsidian v0.12.0+。
安装
来自 Obsidian
- 打开
设置
>第三方插件
- 确保安全模式为关闭
- 点击
浏览社区插件
- 搜索此插件
- 点击
安装
- 安装完成后,关闭社区插件窗口,补丁即可使用。
来自 GitHub
- 从 GitHub 存储库的 Releases 部分下载最新版本
- 将文件放入您的保险库的插件文件夹中:
<vault>/.obsidian/plugins/table-extended
- 重新加载 Obsidian
- 如果提示安全模式,您可以禁用安全模式并启用插件。 否则,前往设置,第三方插件,确保安全模式关闭, 然后从那里启用插件。
注意:
.obsidian
文件夹可能是隐藏的。在 macOS 上,您可以按Command+Shift+Dot
来在 Finder 中显示该文件夹。
幕后
由于当前 Obsidian API 的限制,内置的 Markdown 解析器不可配置。相反,该插件包含一个独立的 Markdown 解析器 markdown-it 和插件 markdown-it-multimd-table,表格部分和带有语言标签 tx
的代码块内的文本将被传递给 markdown-it
。然而,内部链接和嵌入内容将被提取并传递给 Obsidian,因此 Obsidian 的核心功能仍然完整。
请注意,该插件的行为可能与官方的 MultiMarkdown 编译器和 Obsidian 的解析器不同,如果对于合理的输入出现意外结果,请提出问题。
反馈交流
其他渠道
版权声明
版权声明:所有 PKMer 文章如果需要转载,请附上原文出处链接。