{"id":28327034,"url":"https://github.com/zilong-li/org-tufte","last_synced_at":"2026-02-11T06:03:03.949Z","repository":{"id":181787119,"uuid":"611681830","full_name":"Zilong-Li/org-tufte","owner":"Zilong-Li","description":"Export org file to the beauty Tufte html","archived":false,"fork":false,"pushed_at":"2025-11-18T13:16:05.000Z","size":10640,"stargazers_count":87,"open_issues_count":2,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-18T15:58:18.476Z","etag":null,"topics":["emacs-package","orgmode","tufte-css"],"latest_commit_sha":null,"homepage":"https://zilongli.org/code/org-tufte-example.html","language":"Emacs Lisp","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Zilong-Li.png","metadata":{"files":{"readme":"readme.org","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-03-09T10:27:09.000Z","updated_at":"2025-11-18T13:12:13.000Z","dependencies_parsed_at":"2024-03-14T21:38:16.724Z","dependency_job_id":"6d90ad36-edca-49f6-a160-bb01134e5360","html_url":"https://github.com/Zilong-Li/org-tufte","commit_stats":null,"previous_names":["zilong-li/org-tufte"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/Zilong-Li/org-tufte","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zilong-Li%2Forg-tufte","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zilong-Li%2Forg-tufte/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zilong-Li%2Forg-tufte/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zilong-Li%2Forg-tufte/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Zilong-Li","download_url":"https://codeload.github.com/Zilong-Li/org-tufte/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zilong-Li%2Forg-tufte/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29327865,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-11T03:52:29.695Z","status":"ssl_error","status_checked_at":"2026-02-11T03:52:23.094Z","response_time":97,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["emacs-package","orgmode","tufte-css"],"created_at":"2025-05-26T01:16:11.971Z","updated_at":"2026-02-11T06:03:03.943Z","avatar_url":"https://github.com/Zilong-Li.png","language":"Emacs Lisp","funding_links":[],"categories":[],"sub_categories":[],"readme":"#+title: Org file to beautiful Tufte html with one command\n\nI really like the design of Edward Tufte’s handouts. However, there is no single command for just exporting a org file to the Tufte-like html for lazy people like me or newbie who don't know too much about org mode setups. Although there is [[https://github.com/dakrone/ox-tufte][ox-tufte]] intending to do the job, it didn't solve that the org-exported html template is not totally compatible with the [[https://edwardtufte.github.io/tufte-css/][Tufte CSS]] and the generated page is not responsive on mobile device. Also, its configuration makes it hard to use for newbie. Based on my own taste, I added some nice features by tweaking the html template and curating [[https://zilongli.org/code/org.css][my CSS]].\n\n* Screenshot\n\nsee the [[https://zilongli.org/code/org-tufte-example.html][example]] page here and the [[https://zilongli.org/code/org-tufte-example.org][org]] file.\n\n[[file:screen-demo-1.png]]\n[[file:screen-demo-2.png]]\n\n* Features\n- modern responsive html page.\n- embed image in exported html so that its self-contained!\n- one command =M-x export-org-tufte-html= just give me what I want\n- use fast and powerful =katex= instead of =mathjax= to render math.\n- nice source code display by using =et-book-ligatures= font\n- just works without having any org options, eg. =#+html_head:=\n- go to top of page \n\n* Installation\n\n** manual\n\nJust fetch [[file:org-tufte.el]] and save it somewhere. Then load it\n\n#+begin_src emacs-lisp\n(add-to-list 'load-path \"/path/to/org-tufte\")\n(require 'org-tufte)\n#+end_src\n\n** use-package\n\n#+begin_src emacs-lisp\n(use-package org-tufte\n  :ensure nil\n  :load-path \"PATH\"\n  :config\n  (setq org-tufte-htmlize-light-theme nil  ;; disable the default light theme\n        org-tufte-embed-images nil ;; do not embed images. faster!\n        org-tufte-goto-top-button t ;; add go-to-top button in html\n        org-html-html5-fancy t  ;; enable html5 elements\n        org-html-doctype \"html5\" ;; html5 page\n        )\n  )\n#+end_src\n\n* Customization\n\n** Dark theme\n\nCurrently, I used a light theme. If you want the dark theme of the original tufte.css, you should add this setup. \n\n#+begin_src emacs-lisp\n(setq org-tufte-htmlize-light-theme nil)\n#+end_src\n\n** highlighting source code\n\nYou can disable the source code highlighting by customizing the option of org-mode like the following\n\n#+begin_src emacs-lisp\n(setq org-html-htmlize-output-type nil)\n#+end_src\n\n** embedding images in html\nThe default org html-export does not embed images. Hence, you have\nto send archives including images when you share your html page to\nother people. I feel it is very convenient to just share a single\nself-contained html, so =org-tufte= enables embedding images in html\nby default. But it may be a bit *slow* if there are too many large\nimages. If you don't like it, you can disable it by the following\nconfiguration.\n\n#+begin_src emacs-lisp\n(setq org-tufte-embed-images nil)\n#+end_src\n\n* Changelog\n** v0.9.0\n- rename `org-tufte-htmlize-code' to `org-tufte-htmlize-light-theme'\n- disable the source code highlighting by  (setq org-html-htmlize-output-type nil)\n** v0.8.0\n- fullwidth image is supported for html5 page via =#+attr_html: :class fullwidth=\n** v0.7.0\n- Can work properly with ~rg-publish-org-to~\n** v0.6.0\n- Make ~export-org-tufte-html~ command as function\n** v0.5.0\n- Make figure caption a marginnote. [[https://github.com/Zilong-Li/org-tufte/pull/5][#5]]\n- New option: ~org-tufte-posted-string~. [[https://github.com/Zilong-Li/org-tufte/pull/4][#4]]\n- New option: ~org-tufte-goto-top-button~.\n** v0.4.0\n- add button to go to top of page [fn:1]\n** v0.3.0\n- show date and author under title if =#+date:= is defined\n** v0.2.0\n- embed images in html!\n** v0.1.0\n- first release\n* Footnotes\n[fn:1] user can custmoize this\n\n* Credits\nsome codes are copied from\n- https://github.com/dakrone/ox-tufte\n- https://github.com/sulami/sulami.github.io/blob/develop/config.el\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzilong-li%2Forg-tufte","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzilong-li%2Forg-tufte","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzilong-li%2Forg-tufte/lists"}