{"id":13418228,"url":"https://github.com/visit1985/mdp","last_synced_at":"2025-05-13T15:09:03.678Z","repository":{"id":20738037,"uuid":"24022333","full_name":"visit1985/mdp","owner":"visit1985","description":"A command-line based markdown presentation tool.","archived":false,"fork":false,"pushed_at":"2025-01-26T12:12:50.000Z","size":363,"stargazers_count":5048,"open_issues_count":16,"forks_count":257,"subscribers_count":73,"default_branch":"master","last_synced_at":"2025-04-23T18:56:51.933Z","etag":null,"topics":["command-line","markdown","presentation"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"astuetz/PagerSlidingTabStrip","license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/visit1985.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-09-14T13:18:50.000Z","updated_at":"2025-04-23T12:11:42.000Z","dependencies_parsed_at":"2022-07-12T15:17:51.516Z","dependency_job_id":"8bae0f39-7db6-4ee0-ad15-da87f7b963d6","html_url":"https://github.com/visit1985/mdp","commit_stats":{"total_commits":263,"total_committers":44,"mean_commits":"5.9772727272727275","dds":"0.44106463878326996","last_synced_commit":"4664cb261145fbd2b164b0ca507af8ceb76ded9c"},"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/visit1985%2Fmdp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/visit1985%2Fmdp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/visit1985%2Fmdp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/visit1985%2Fmdp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/visit1985","download_url":"https://codeload.github.com/visit1985/mdp/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253969238,"owners_count":21992262,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["command-line","markdown","presentation"],"created_at":"2024-07-30T22:00:59.931Z","updated_at":"2025-05-13T15:08:58.666Z","avatar_url":"https://github.com/visit1985.png","language":"C","readme":"\n## mdp - A command-line based markdown presentation tool.\n\n![image](https://cloud.githubusercontent.com/assets/2237222/5810237/797c494c-a043-11e4-9dbd-959cab4055fa.gif)\n\n---\n\n***How to get started:***\n\nmdp needs the ncursesw headers to compile.\nSo make sure you have them installed:\n\n- on Raspbian (Raspberry Pi) you need `libncurses5-dev` and `libncursesw5-dev`\n- on Fedora you need `ncurses-devel` and `ncurses-c++-libs`\n\nNow download and install mdp:\n\n    $ git clone https://github.com/visit1985/mdp.git\n    $ cd mdp\n    $ make\n    $ make install\n    $ mdp sample.md\n\n- On Arch Linux, you can use the existing [package](https://www.archlinux.org/packages/extra/x86_64/mdp/).\n- on Cygwin you can use the existing [package](https://cygwin.com/cgi-bin2/package-grep.cgi?grep=mdp.exe) from the setup program.\n- On Debian, you can use the existing [DEB package](https://tracker.debian.org/pkg/mdp-src), or run `apt-get install mdp`.\n- On FreeBSD, you can use the port [misc/mdp](http://www.freshports.org/misc/mdp).\n- On MacOS, use either the [Homebrew Formula](http://brewformulas.org/Mdp) by running `brew install mdp` or install with [MacPorts](https://ports.macports.org/port/mdp/) with `sudo port install mdp`.\n- On Slackware, grab the SlackBuild here: (http://slackbuilds.org/apps/mdp/), or run `sbopkg -i mdp`.\n- On Ubuntu, you can use the existing [DEB package](https://launchpad.net/ubuntu/+source/mdp-src), or run `apt-get install mdp`.\n\nMost terminals support 256 colors only if the TERM variable is\nset correctly. To enjoy mdp's color fading feature:\n\n    $ export TERM=xterm-256color\n\n---\n\n***How to use it:***\n\nHorizontal rulers are used as slide separator.\n\nSupports basic markdown formatting:\n\n- line wide markup\n    - headlines\n    - code\n    - quotes\n    - unordered list\n\n- in-line markup\n    - bold text\n    - underlined text\n    - code\n\nSupports headers prefixed by @ symbol.\n\n- first two header lines are displayed as title and author\n    in top and bottom bar\n\nReview sample.md for more details.\n\n---\n\n***Default controls:***\n\n- h, j, k, l, Arrow keys,\n    Space, Enter, Backspace,\n    Page Up, Page Down - next/previous slide\n- Home, g - go to first slide\n- End, G - go to last slide\n- 1-9 - go to slide n\n- r - reload input file\n- q - exit\n\n---\n\n***Configuration***:\n\nA `config.h` configuration file is available in `include/`, change the settings you want and recompile.\nColors, keybindings and list types are configurable as of now. Note that configuring colors only works in 8 color mode.\n\n---\n\n***How to debug it:***\n\nTo make a debug version of `mdp`, just type:\n\n    $ make DEBUG=1\n\n***Convert to PDF:***\n\n- Install `md2pdf` by obtaining the [release](https://github.com/mandolyte/mdtopdf/releases) for your arch and OS or, if\n  you have `go` installed, invoke:\n\n```sh\n$ go install github.com/mandolyte/mdtopdf/cmd/md2pdf@latest\n```\n- If you require syntax highlighting, download the [gohighlight lexers](https://github.com/jessp01/gohighlight/tree/master/syntax_files)\n\n`md2pdf` supports all major `mdp` features and accepts local files, remote HTTP(s) URL and `STDIN` inputs.\nThe below command will convert an `mdp` compatible markdown file to a PDF with a dark theme,\nsyntax highlighting (you'll need to provide the language hint, of course), page/slide separation and a footer:\n\n```sh\nmd2pdf -i https://github.com/jessp01/crash-course-in/raw/main/courses/apt_dpkg_deb/apt_dpkg_deb.md \\\n    -o apt_dpkg_deb.pdf \\\n    -s ~/.config/zaje/syntax_files \\\n    --theme dark \\\n    --new-page-on-hr \\\n    --with-footer \\\n    --author \"Jesse Portnoy \u003cjesse@packaman.io\u003e\" \\\n    --title \"A crash course on handling deb packages\"\n```\n\nSince `markdown` does not support the centering escape sequences (i.e: `-\u003e` and `\u003c-`), you will want to remove these before converting, for example:\n\n```sh\n$ sed 's@^-\u003e\\s*\\(#.*\\)\\s*\u003c-@\\1@g' sample.md | ~/go/bin/md2pdf -o mdp.pdf \\\n    --theme dark --new-page-on-hr\n```\n\n","funding_links":[],"categories":["C","Productivity","Misc","Tools","markdown","Uncategorized","\u003ca name=\"office\"\u003e\u003c/a\u003eOffice tools","办公与协作工具","ASCII"],"sub_categories":["Presentations","Uncategorized","幻灯片"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvisit1985%2Fmdp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvisit1985%2Fmdp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvisit1985%2Fmdp/lists"}