返回顶部
o

obsidian-markdown黑曜石Markdown

Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes.

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 1.0.0
安全检测
已通过
824
下载量
免费
免费
0
收藏
概述
安装方式
版本历史

obsidian-markdown

Obsidian 风格 Markdown 技能

创建和编辑有效的 Obsidian 风格 Markdown。Obsidian 通过维基链接、嵌入、标注、属性、注释和其他语法扩展了 CommonMark 和 GFM。本技能仅涵盖 Obsidian 特有的扩展——标准 Markdown(标题、粗体、斜体、列表、引用、代码块、表格)视为已掌握知识。

工作流程:创建 Obsidian 笔记

  1. 1. 添加前言,在文件顶部使用属性(标题、标签、别名)。所有属性类型请参见 PROPERTIES.md
  2. 编写内容,使用标准 Markdown 构建结构,并配合下方 Obsidian 特有语法。
  3. 链接相关笔记,使用维基链接([[笔记]])进行内部仓库连接,或使用标准 Markdown 链接指向外部 URL。
  4. 嵌入内容,使用 ![[嵌入]] 语法嵌入其他笔记、图片或 PDF。所有嵌入类型请参见 EMBEDS.md
  5. 添加标注,使用 > [!类型] 语法突出显示信息。所有标注类型请参见 CALLOUTS.md
  6. 验证笔记在 Obsidian 阅读视图中正确渲染。

在维基链接和 Markdown 链接之间选择时:对于仓库内的笔记使用 [[维基链接]](Obsidian 会自动跟踪重命名),仅对外部 URL 使用 文本

内部链接(维基链接)

markdown
[[笔记名称]] 链接到笔记
[[笔记名称|显示文本]] 自定义显示文本
[[笔记名称#标题]] 链接到标题
[[笔记名称^块ID]] 链接到块
[[#同一笔记中的标题]] 同一笔记内的标题链接

通过在任意段落后追加 ^块ID 来定义块 ID:

markdown
此段落可以被链接。^我的块ID

对于列表和引用,将块 ID 放在块后的单独一行:

markdown

一个引用块

^引用ID

嵌入

在任何维基链接前加上 ! 即可内联嵌入其内容:

markdown
![[笔记名称]] 嵌入完整笔记
![[笔记名称#标题]] 嵌入章节
![[image.png]] 嵌入图片
![[image.png|300]] 嵌入图片并指定宽度
![[document.pdf#page=3]] 嵌入 PDF 页面

音频、视频、搜索嵌入和外部图片请参见 EMBEDS.md

标注

markdown

[!note]

基本标注。

[!warning] 自定义标题
带有自定义标题的标注。

[!faq]- 默认折叠
可折叠标注(- 折叠,+ 展开)。

常见类型:note、tip、warning、info、example、quote、bug、danger、success、failure、question、abstract、todo。

完整列表(含别名、嵌套和自定义 CSS 标注)请参见 CALLOUTS.md

属性(前言)

yaml



title: 我的笔记
date: 2024-01-15
tags:
- 项目
- 活跃
aliases:
- 替代名称
cssclasses:
- 自定义类


默认属性:tags(可搜索标签)、aliases(链接建议的替代笔记名称)、cssclasses(用于样式的 CSS 类)。

所有属性类型、标签语法规则和高级用法请参见 PROPERTIES.md

标签

markdown
#标签 内联标签
#嵌套/标签 带层级的嵌套标签

标签可包含字母、数字(不能作为首字符)、下划线、连字符和正斜杠。标签也可在前言的 tags 属性中定义。

注释

markdown
这是可见的 %%但这是隐藏的%% 文本。

%%
整个块在阅读视图中隐藏。
%%

Obsidian 特有格式

markdown
==高亮文本== 高亮语法

数学公式(LaTeX)

markdown
内联:$e^{i\pi} + 1 = 0$

块级:
$$
\frac{a}{b} = c
$$

图表(Mermaid)

markdown
mermaid
graph TD
A[开始] --> B{决策}
B -->|是| C[执行此操作]
B -->|否| D[执行彼操作]

要将 Mermaid 节点链接到 Obsidian 笔记,请添加 class NodeName internal-link;。

脚注

markdown
带有脚注的文本[^1]。

[^1]: 脚注内容。

内联脚注。^[这是内联的。]

完整示例

markdown



title: Alpha 项目
date: 2024-01-15
tags:
- 项目
- 活跃
status: 进行中


Alpha 项目

本项目旨在使用现代技术[[改进工作流程]]。

[!important] 关键截止日期
第一个里程碑应于 ==1月30日== 前完成。

任务

  • - [x] 初步规划
  • [ ] 开发阶段
- [ ] 后端实现 - [ ] 前端设计

笔记

该算法使用 $O(n \log n)$ 排序。详情请参见 [[算法笔记#排序]]。

![[架构图.png|600]]

已在 [[会议记录 2024-01-10#决策]] 中审阅。

参考

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 obsidian-markdown-1776209381 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 obsidian-markdown-1776209381 技能

通过命令行安装

skillhub install obsidian-markdown-1776209381

下载

⬇ 下载 obsidian-markdown v1.0.0(免费)

文件大小: 4.84 KB | 发布时间: 2026-4-15 11:22

v1.0.0 最新 2026-4-15 11:22
- Initial release of the obsidian-markdown skill.
- Supports creating and editing Obsidian Flavored Markdown, including wikilinks, embeds, callouts, properties, tags, comments, highlighting, and more.
- Covers Obsidian-specific syntax extensions in detail, with examples and references.
- Assumes basic knowledge of standard Markdown.
- Includes workflow guidance and a comprehensive example note.

Archiver·手机版·闲社网·闲社论坛·羊毛社区· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2025 闲社网·线报更新论坛·羊毛分享社区·http://xianshe.com

p2p_official_large
返回顶部