Back to Details

video-note

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Video Note Publishing

视频笔记发布

Transform video notes from 
/Users/joel/Vault/Resources/videos/
into published MDX notes on the joelclaw.com site at 
apps/web/content/
.
将
/Users/joel/Vault/Resources/videos/
路径下的视频笔记转换为joelclaw.com站点
apps/web/content/
目录下的已发布MDX笔记。

Source format

源格式

Vault video notes are Obsidian markdown with this frontmatter:
yaml
type: video
source: https://www.youtube.com/watch?v=ID
channel: Channel Name
published: YYYY-MM-DD
duration: "HH:MM:SS"
nas_path: /volume1/home/joel/video/...
transcribed: YYYY-MM-DD
tags:
  - video
Body contains: H1 title, 
> [!info] Source
callout, Executive Summary, Key Points, Speaker Context, Notable Quotes, Related links, Tags, and a collapsible Full Transcript.
Vault视频笔记是带有如下frontmatter的Obsidian markdown文件：
yaml
type: video
source: https://www.youtube.com/watch?v=ID
channel: Channel Name
published: YYYY-MM-DD
duration: "HH:MM:SS"
nas_path: /volume1/home/joel/video/...
transcribed: YYYY-MM-DD
tags:
  - video
正文包含：H1标题、
> [!info] Source
标注块、执行摘要、核心要点、演讲者背景、金句摘录、相关链接、标签，以及可折叠的完整逐字稿。

Output format

输出格式

Publish as 
.mdx
in 
apps/web/content/
with this frontmatter:
yaml
title: "Short descriptive title"
type: "note"
date: "YYYY-MM-DD"        # use today's date
description: "One-sentence hook in Joel's voice"
source: "YouTube URL"
channel: "Channel Name"
duration: "HH:MM:SS"
发布为
apps/web/content/
目录下的
.mdx
文件，带有如下frontmatter：
yaml
title: "Short descriptive title"
type: "note"
date: "YYYY-MM-DD"        # 使用当天日期
description: "One-sentence hook in Joel's voice"
source: "YouTube URL"
channel: "Channel Name"
duration: "HH:MM:SS"

Transformation workflow

转换工作流

  1. Read the source vault note
  2. Extract YouTube video ID from the 
    source
    URL
  3. Write the note in Joel's voice (read 
    joel-writing-style
    skill — it's in the same 
    .agents/skills/
    directory). Key rules:
    • Open with a hook, not a summary
    • Add a personal "why this matters to me" frame connecting the video to JoelClaw
    • Use short paragraphs, strategic profanity, bold for emphasis
    • End abruptly — no forced wrap-up
  4. Embed the video with 
    <YouTube id="VIDEO_ID" />
    after the intro
  5. Include everything from the vault note except the full transcript:
    • Executive summary → rewrite as the intro (Joel's voice)
    • Key points → keep substance, tighten prose
    • Speaker context → "Who is [Speaker]" section
    • Notable quotes → curated "Quotes that stuck with me"
    • Related links → keep as "Related" section
  6. Strip Obsidian syntax: 
    > [!info]
    callouts → plain text, 
    [[wikilinks]]
    → markdown links
  7. Slug: kebab-case, concise (e.g., 
    openclaw-peter-steinberger-lex-fridman
    )
  1. 读取源Vault笔记
  2. 从
    source
    URL中提取YouTube视频ID
  3. 用Joel的语气撰写内容（参考
    .agents/skills/
    同目录下的
    joel-writing-style
    技能），核心规则：
    • 开头用钩子引入，不要直接放摘要
    • 添加个人化的「对我而言重要的原因」框架，将视频内容和JoelClaw关联起来
    • 使用短段落，适度使用口语化粗话，用加粗强调重点
    • 结尾干脆，不要强行总结
  4. 在引言后用
    <YouTube id="VIDEO_ID" />
    嵌入视频
  5. 保留Vault笔记中除完整逐字稿外的所有内容：
    • 执行摘要 → 重写为引言（用Joel的语气）
    • 核心要点 → 保留实质内容，精简措辞
    • 演讲者背景 → 设为「[演讲者姓名]是谁」板块
    • 金句摘录 → 整理为「打动我的句子」板块
    • 相关链接 → 保留为「相关内容」板块
  6. 移除Obsidian专属语法：
    > [!info]
    标注块转为纯文本，
    [[wikilinks]]
    转为标准markdown链接
  7. Slug：采用kebab-case格式，简洁明了（例如
    openclaw-peter-steinberger-lex-fridman
    ）

Voice reference

语气参考

For Joel's writing style details, read joel-writing-style SKILL.md and its voice examples. Key points:
  • Conversational first person, address reader as "you"
  • Contractions always
  • Bold for inline emphasis on key phrases
  • Emoji sparingly (1-2 per note max)
  • Headers as narrative beats, not outlines
  • Links woven into sentences, never "click here"
  • Credit people by name with links
如需了解Joel写作风格的详细说明，可阅读joel-writing-style SKILL.md及其语气示例，核心要点：
  • 采用第一人称对话语气，称呼读者为「你」
  • 一律使用缩写形式
  • 对关键短语使用加粗进行行内强调
  • 谨慎使用emoji（每条笔记最多1-2个）
  • 标题作为叙事节点，不要写成大纲形式
  • 链接嵌入句子中，不要使用「点击这里」这类表述
  • 提及人名时附上链接标注来源

Content system details

内容系统详情

See content-system.md for the joelclaw.com content types, MDX components, and routing.
查看content-system.md了解joelclaw.com的内容类型、MDX组件和路由规则。

Example

示例

See example-note.md for a complete published note showing the target format and voice.
查看example-note.md获取完整的已发布笔记示例，可参考目标格式和语气要求。