ilias-sp / markdown-browser

Github flavoured, local file browser (a single PHP file without dependencies) for viewing your project's markdown documentation files. Also, see https://github.com/websemantics/markdown-browser-plus

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Forked version info

forked from https://github.com/websemantics/markdown-browser.

Additions/enhancements:

  • Dark theme
  • Various aesthetical tunings
  • Name-flexible (index.php name not mandatory)

 ─────    ╭──┬──╮ ╭──╮ ┬──╮ ┬ ╭─ ╭┬─╮ ╭──╮ ┬   ┬ ╭─╮ ╭   ╭──╮  ┬──╮ ╭──╮ ┬   ┬ ╭──╮ ╭──╮ ┬──╮    ─────
   ────   │  │  │ ├──┤ ├─┬╯ ├─┴╮  │ │ │  │ │ │ │ │ │ │   ├──┴╮ ├─┬╯ │  │ │ │ │ ╰──╮ ├─┤  ├─┬╯   ────
      ──  ┴  ┴  ┴ ┴  ┴ ┴ ╰─ ┴  ┴ ─┴─╯ ╰──╯ ╰─┴─╯ ╯ ╰─╯   ╰───╯ ┴ ╰─ ╰──╯ ╰─┴─╯ ╰──╯ ╰──╯ ┴ ╰─  ──

Straightforward file browser for viewing markdown and other file types locally in Github-like fashion.

Look Mum, No Hands

This project was put together to solve the problem of having to push changes to Github too often -while writing README, documentation files- just to see how they look live. It also lifts the burden of having to use static site generators to produce redundant html files from markdown while developing locally.

Having a markdown viewer as a single PHP file keeps things simple and pleasant until you decide to push changes to Github for the world to see.

Getting Started

Drop index.php in your projects's documentation folder then view it in the browser, that's it!

Preview

The docs folder featured is from Svelte project.

Baked-in Goodies

Credits to the following projects for making this possible,

Support

Need help or have a question? post at StackOverflow.

Please don't use the issue trackers for support/questions.

Star if you find this project useful, to show support or simply for being awesome :)

Contribution

Contributions to this project are accepted in the form of feedback, bugs reports and even better - pull requests.

License

MIT license Copyright (c) Web Semantics, Inc.

About

Github flavoured, local file browser (a single PHP file without dependencies) for viewing your project's markdown documentation files. Also, see https://github.com/websemantics/markdown-browser-plus

License:MIT License


Languages

Language:PHP 100.0%