Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Timeline

george-debuggeorge-debug83k downloads

Build great timelines.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates6

We recommend you use the snippet instead for footnotes and node links and use it with other plugins.

Create your own timeline

How to use it

Choose the timeline or timeline-labeled tag

  • timeline tag

    Requires + at the beginning of each line:

    • each event has 3 +s in total: 1 for time, 1 for title and 1 for content
    • you can separate them with empty lines if it's easier for you to write
    ```timeline
    [line-3, body-2]
    + pre</br> 17th century
    + Origins of coffee
    + The modern version of roasted coffee originated in Arabia. During the 13th century, coffee was extremely popular with the Muslim community for its stimulant powers, which proved useful during long prayer sessions. By parching and boiling the coffee beans, rendering them infertile, the Arabs were able to corner the market on coffee crops. In fact, tradition says that not a single coffee plant existed outside of Arabia or Africa until the 1600s, when Baba Budan, an Indian pilgrim, left Mecca with fertile beans fastened to a strap across his abdomen. Baba’s beans resulted in a new and competitive European coffee trade.
    
    + 17th century
    + Europe and coffee
    + In 1616, the Dutch founded the first European-owned coffee estate in Sri Lanka, then Ceylon, then Java in 1696. The French began growing coffee in the Caribbean, followed by the Spanish in Central America and the Portuguese in Brazil. European coffee houses sprang up in Italy and later France, where they reached a new level of popularity. Now, it is de _rigueur_ for Parisians to indulge in a cup of coffee and a baguette or croissant at the numerous coffee cafes throughout Paris.
    ```
    
  • timeline-labeled tag

    • each event has a corresponding label (date, title and content) that starts the line
    • you can separate them with empty lines if it's easier for you to write
    ```timeline-labeled
    [line-3, body-2]
    date: pre</br> 17th century
    title: Origins of coffee
    content:
    The modern version of roasted coffee originated in Arabia. During the 13th century, coffee was extremely popular with the Muslim community for its stimulant powers, which proved useful during long prayer sessions. By parching and boiling the coffee beans, rendering them infertile, the Arabs were able to corner the market on coffee crops. In fact, tradition says that not a single coffee plant existed outside of Arabia or Africa until the 1600s, when Baba Budan, an Indian pilgrim, left Mecca with fertile beans fastened to a strap across his abdomen. Baba’s beans resulted in a new and competitive European coffee trade.
    
    date: 17th century
    title: Europe and coffee
    content:
    In 1616, the Dutch founded the first European-owned coffee estate in Sri Lanka, then Ceylon, then Java in 1696. The French began growing coffee in the Caribbean, followed by the Spanish in Central America and the Portuguese in Brazil. European coffee houses sprang up in Italy and later France, where they reached a new level of popularity. Now, it is de _rigueur_ for Parisians to indulge in a cup of coffee and a baguette or croissant at the numerous coffee cafes throughout Paris.
    ```
    

[] is optional!

You can use [] at the beginning of the code-block to add pre-written classes or your own classes to the wrapper.

Customize

Using pre-written classes for line, body and the active color:

  • line:

    • line-2
    • line-3
    • line-4
    • line-5
  • body:

    • body-2
    • body-3
    • body-4
  • active color:

    • active-color-background-modifier-success
    • active-color-background-modifier-error
    • active-color-background-modifier-error-hover
    • active-color-text-accent
    • active-color-text-accent-hover
    • active-color-text-error
    • active-color-text-error-hover
    • active-color-text-selection
    • active-color-interactive-accent
    • active-color-interactive-accent-hover
    • active-color-interactive-success

Timiline with colors

For active color we use obsidian's css variables as active colors, so it matches the theme. The default active color is background-modifier-success. If you want your own color use --timeline-active-color css variable attached to .timeline class

.timeline
    --timeline-active-color: #00c137

Special Thanks

  • Welding Torch
  • Ivan Che

Support

57%
HealthFair
ReviewCaution
About
Create chronological timelines from simple Markdown by using timeline or timeline-labeled blocks. Define events with three +‑prefixed lines (time, title, content) or with labeled lines (date:, title:, content:), and separate events with blank lines for readability.
VisualizationDatesMarkdown
Details
Current version
1.1.0
Last updated
4 years ago
Created
5 years ago
Updates
6 releases
Downloads
83k
Compatible with
Obsidian 0.15.6+
Platforms
Desktop, Mobile
License
MIT
Report bugRequest featureReport plugin
Author
george-debuggeorge-debug
GitHubgeorge-debug
  1. Community
  2. Plugins
  3. Visualization
  4. Timeline

Related plugins

Markwhen

Create timelines, gantt charts, calendars, and more using markwhen.

AnyBlock

Take any fragment as a block and render it into multiple effects.

April's Automatic Timelines

Simple timeline generator for story tellers.

Prisma Calendar

Prisma turns any note with a date into a flexible planning system inside Obsidian. There are no rigid schemas or predefined structures — just your data, your rules, fully under your control.

Advanced Canvas

Supercharge your canvas experience. Create presentations, flowcharts and more.

Importer

Import data from Notion, Evernote, Apple Notes, Microsoft OneNote, Google Keep, Bear, Roam, and HTML files.

Day Planner

Day planning from a task list in a Markdown note with enhanced time block functionality.

Excalidraw

Visual PKM powerhouse. Create and edit Excalidraw drawings.

Outliner

Work with your lists like in Workflowy or Roam Research.

Mermaid Tools

Improved Mermaid.js experience: visual toolbar with common elements and more.