`lookatme`

lookatme is an interactive, extensible, terminal-based markdown presentation tool.

Features

Markdown rendering
Built-in tutorial slides lookatme --tutorial
Live (input file modification time watching) and manual reloading
Live terminals embedded directly in slides
Syntax highlighting using Pygments
Loading external files into code blocks
Support for contrib extensions
Smart slide splitting
Progressive slides with  comments between block elements

Tutorial

pip install --upgrade lookatme
lookatme --tutorial

NOTE: lookatme 3.0 is nearing completion! Check out the latest release candidate with: pip install --upgrade --pre lookatme. Be warned, version 3.0 may not be as stable and contains breaking changes (mostly with styles) from previous major versions.

General tour

lookatme_tour

Embedded terminal example

terminal example

Sourcing external files example

file loader example

Navigating the Presentation

Action	Keys	Notes
Next Slide	`l j right space`
Prev Slide	`h k left delete backspace`
Quit	`q Q`
Terminal Focus	Click on the terminal
Exit Terminal	`ctrl+a` and then a slide action
Vertically scroll within slide	`up/down or page up/page down`

CLI Options

Usage: lookatme [OPTIONS] [INPUT_FILES]...

  lookatme - An interactive, terminal-based markdown presentation tool.

  See https://lookatme.readthedocs.io/en/v{{VERSION}} for documentation

Options:
  --debug
  -l, --log PATH
  --tutorial TEXT                 As a flag: show all tutorials. With a
                                  value/comma-separated values: show the
                                  specific tutorials. Use the value 'help' for
                                  more help
  -t, --theme [dark|light]
  --style [default|emacs|friendly|friendly_grayscale|colorful|autumn|murphy|manni|material|monokai|perldoc|pastie|borland|trac|native|fruity|bw|vim|vs|tango|rrt|xcode|igor|paraiso-light|paraiso-dark|lovelace|algol|algol_nu|arduino|rainbow_dash|abap|solarized-dark|solarized-light|sas|staroffice|stata|stata-light|stata-dark|inkpot|zenburn|gruvbox-dark|gruvbox-light|dracula|one-dark|lilypond|nord|nord-darker|github-dark]
  --dump-styles                   Dump the resolved styles that will be used
                                  with the presentation to stdout
  --live, --live-reload           Watch the input filename for modifications
                                  and automatically reload
  -s, --safe                      Do not load any new extensions specified in
                                  the source markdown. Extensions specified
                                  via env var or -e are still loaded
  --no-ext-warn                   Load new extensions specified in the source
                                  markdown without warning
  -i, --ignore-ext-failure        Ignore load failures of extensions
  -e, --exts TEXT                 A comma-separated list of extension names to
                                  automatically load (LOOKATME_EXTS)
  --single, --one                 Render the source as a single slide
  --version                       Show the version and exit.
  --help                          Show this message and exit.

Known Extensions

Below is a list of known extensions for lookatme:

Extension Name	Install Name	Notes
qrcode	lookatme.contrib.qrcode	Renders QR codes from code blocks
image_ueberzug	lookatme.contrib.image_ueberzug	Renders images with ueberzug (Linux only)
render	lookatme.contrib.render	Renders supported code blocks (graphviz and mermaid-js) by calling an external program. requires an image-rendering extension

Documentation

See the documentation for details.

Project Name	Stars	Repos Using This	Packages Using This	Most Recent Commit	Total Releases	Latest Release	Open Issues	License	Language
Tldr	46,547			18 hours ago			151	other	Markdown
📚 Collaborative cheatsheets for console commands
Marked	30,959	90,501	11,796	a day ago	162	November 29, 2023	16	other	TypeScript
A markdown parser and compiler. Built for speed.
Linux Command	25,788	2	3	3 days ago	44	February 24, 2023	66	mit	Markdown
Linux命令大全搜索工具，内容包含Linux命令手册、详解、学习、搜集。https://git.io/linux
Glow	13,697		15	14 days ago	27	May 09, 2023	127	mit	Go
Render markdown on the CLI, with pizzazz! 💅🏻
Zettlr	9,153			a day ago			357	gpl-3.0	TypeScript
Your One-Stop Publication Workbench
Marp	8,045			4 years ago				mit
The site of classic Markdown presentation writer app
Nb	5,874		2	3 days ago	304	November 28, 2023	109	agpl-3.0	Shell
CLI and local web plain text note‑taking, bookmarking, and archiving with linking, tagging, filtering, search, Git versioning & syncing, Pandoc conversion, + more, in a single portable script.
Mdp	4,789			25 days ago	1	February 27, 2018	16	gpl-3.0	C
A command-line based markdown presentation tool.
Percollate	4,002		2	6 days ago	64	November 25, 2023	13	mit	JavaScript
A command-line tool to turn web pages into readable PDF, EPUB, HTML, or Markdown docs.
Assemble	3,788	3,606	272	4 years ago	119	May 20, 2017	29	mit	CSS
Get the rocks out of your socks! Assemble makes you fast at web development! Used by thousands of projects for rapid prototyping, themes, scaffolds, boilerplates, e-books, UI components, API documentation, blogs, building websites/static site generator, an alternative to Jekyll for gh-pages and more! Gulp- and grunt-friendly.

Lookatme