一个简单、优雅、中文友好的 Obsidian 时间轴渲染插件。 A simple, elegant, Chinese-friendly timeline rendering plugin for Obsidian. 当前版本 (Current version): 1.4.8

简介

1st Timeline 是一个 Obsidian 插件，可将简单的文本代码块渲染为精美的时间轴视图。支持多种日期格式（含中文日期优先支持），智能日期解析，优雅的视觉呈现——帮助您轻松创建时间线、项目进度视图或历史事件记录。

1st Timeline renders beautiful timeline views from simple text code blocks. It supports multiple date formats with first-class Chinese date support, intelligent parsing, and elegant visual presentation.

安装

从 Obsidian 社区插件市场（推荐）

1. 打开 Obsidian 设置 → 社区插件
2. 关闭"安全模式"
3. 点击"浏览"，搜索 "1st Timeline"
4. 安装并启用

从 GitHub Releases 安装

1. 前往 Releases 页面
2. 下载最新版本的 main.js、manifest.json、styles.css
3. 在 vault 中创建目录 .obsidian/plugins/first-timeline/
4. 将三个文件放入该目录
5. 重启 Obsidian，在 设置 → 社区插件 中启用

从源码构建

git clone https://github.com/lnabc03/1st-Timeline.git
cd 1st-Timeline
npm install
npm run build

然后将 main.js、manifest.json、styles.css 复制到 .obsidian/plugins/first-timeline/，重启并启用。

注意: 目标目录名必须与 manifest.json 中的 id 字段一致（first-timeline）。

使用方法

在 Obsidian 笔记中插入 timeline 代码块：

```timeline
2024-01-01  新年第一天（双空格分隔）
2024年3月8日：妇女节（中文冒号分隔）
2024-05-01: 劳动节（英文冒号分隔）
2025-01-28_12:04  精确时间格式
2025年1月29日早上  中文日期+时间词
2026-01-01
新的一年开始了！（多行文本）
- 支持完整的 Markdown 语法
# 标题
> 引用块
> [!NOTE] Callout
| A | B |
|---|---|
| C | D |
```

语法规则

笔记汇总

使用命令面板（Ctrl+P）执行 "笔记汇总 / Notes summary" 命令：

1. 输入日期范围（格式：YYYY-MM-DD,YYYY-MM-DD）
2. 默认填充当前月份
3. 确认后自动生成基于指定 frontmatter 属性的笔记时间轴

设置选项

开发

对齐 Obsidian 官方示例插件 最佳实践：

npm install          # 安装依赖
npm run dev          # 开发模式（watch）
npm run build        # 生产构建（tsc + esbuild）
npm run lint         # ESLint 代码检查

• 语言: TypeScript（strict 模式）
• 构建: esbuild（CJS 输出，ES2021 target）
• 代码检查: ESLint 9 + typescript-eslint + eslint-plugin-obsidianmd
• CI/CD: GitHub Actions（lint + release）
• 最低 Obsidian 版本: 1.8.7（桌面及移动端）

更新日志

1.4.x — 正式版发布 (2026-06)

• TypeScript 重构、多模块架构、esbuild 构建，完全对齐 Obsidian 官方模板
• 中英文双语支持，自动检测 Obsidian 语言设置
• 重新设计当天事件高亮（内嵌强调色条 + 徽章）
• 移动端全面适配：响应式布局、日期完整显示、光点精准居中
• 社区插件市场上架并通过审核

1.3.x — 自动折叠与笔记汇总 (2025)

• 新增自动折叠和笔记汇总功能
• 修复日期解析相关问题

1.2.x — 交互增强 (2025)

• 添加悬停提示（距今天数）和当天事件高亮

1.1.x — 中文支持 (2025)

• 增加中文日期格式支持和颜色预设主题

1.0.0 — 初始版本 (2025)

• 基础时间轴渲染

许可证

MIT License

作者

lnabc03 | 弋鹓

1st Timeline

A simple, elegant, Chinese-friendly timeline rendering plugin for Obsidian. 一个简单、优雅、中文友好的 Obsidian 时间轴渲染插件。 Current version: 1.4.8

Description

1st Timeline renders beautiful timeline views from simple text code blocks. It supports multiple date formats with first-class Chinese date support, intelligent parsing, and elegant visual presentation — helping you create timelines, project progress views, or historical event records effortlessly.

1st Timeline 是一个 Obsidian 插件，可将简单的文本代码块渲染为精美的时间轴视图。

Installation

From Obsidian Community Plugin Marketplace (Recommended)

1. Open Obsidian Settings → Community plugins
2. Disable Safe mode
3. Click Browse, search for "1st Timeline"
4. Install and enable

From GitHub Releases

1. Go to the Releases page
2. Download the latest main.js, manifest.json, and styles.css
3. Create the directory .obsidian/plugins/first-timeline/ in your vault
4. Copy the three files into that directory
5. Restart Obsidian and enable the plugin in Settings → Community plugins

From Source

git clone https://github.com/lnabc03/1st-Timeline.git
cd 1st-Timeline
npm install
npm run build

Then copy main.js, manifest.json, and styles.css to .obsidian/plugins/first-timeline/, restart Obsidian, and enable.

Note: The target directory name must match the id field in manifest.json (first-timeline).

Usage

Insert a timeline code block in any Obsidian note:

```timeline
2024-01-01  New Year's Day (two spaces)
2024-03-08: International Women's Day (colon)
2024年5月1日：Labor Day (Chinese date + colon)
2025-01-28_12:04  Precise time format
2025年1月29日早上  Chinese date with time-of-day word
2026-01-01
A new year begins! (multi-line text)
- Full Markdown syntax supported
# Headings
> Blockquotes
> [!NOTE] Callouts
| A | B |
|---|---|
| C | D |
```

Syntax Rules

Notes Summary

Use the command palette (Ctrl+P) and run the "Notes summary / 笔记汇总" command:

1. Enter a date range (format: YYYY-MM-DD,YYYY-MM-DD)
2. The current month is pre-filled by default
3. Confirm to insert a timeline of notes based on the configured frontmatter date field

Settings

Development

Follows Obsidian's official sample plugin best practices:

npm install          # Install dependencies
npm run dev          # Development mode (watch)
npm run build        # Production build (tsc + esbuild)
npm run lint         # ESLint check

• Language: TypeScript (strict mode)
• Build: esbuild (CJS output, ES2021 target)
• Linting: ESLint 9 + typescript-eslint + eslint-plugin-obsidianmd
• CI/CD: GitHub Actions (lint + release)
• Minimum Obsidian version: 1.8.7 (desktop and mobile)

Changelog

1.4.x — Official Release (2026-06)

• TypeScript rewrite, multi-module architecture, esbuild build system, aligned with Obsidian template
• Bilingual Chinese/English support with automatic language detection
• Redesigned today-event highlighting (inset accent strip + badge)
• Full mobile adaptation: responsive layout, full date display, precise dot centering
• Published to Obsidian community plugin marketplace

1.3.x — Auto Collapse & Notes Summary (2025)

• Added auto-collapse and notes summary features
• Fixed date parsing issues

1.2.x — Interaction Enhancements (2025)

• Added hover tooltips (days until/since) and today highlighting

1.1.x — Chinese Support (2025)

• Added Chinese date format support and color preset themes

1.0.0 — Initial Release (2025)

• Basic timeline rendering

License

MIT License

Author

lnabc03 | 弋鹓