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-debug94k 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

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
94k
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

Yearly Glance

Year at a glance - overview of annual events with customizable management options.

Excalidraw

Visual PKM powerhouse. Create and edit Excalidraw drawings.

Advanced Canvas

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

ExcaliBrain

An interactive, structured mind-map of your Obsidian vault.

Linter

Format and style your notes. Linter can be used to format YAML tags, aliases, arrays, and metadata; footnotes; headings; spacing; math blocks; regular Markdown contents like list, italics, and bold styles; and more with the use of custom rule options.

Breadcrumbs

Visualise the hierarchy of your vault using a breadcrumb trail or matrix view.

Thino

Quickly capture memos and display them in the sidebar with a heatmap. (Closed source)

Mermaid Tools

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

Custom Frames

Turn web apps into panes using iframes with custom styling. Also comes with presets for Google Keep, Todoist and more.

Tasks

Track tasks across your vault. Supports due dates, recurring tasks, done dates, sub-set of checklist items, and filtering. Maintained by Clare Macrae and Ilyas Landikov, created by Martin Schenck.