Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jjuliano/markdown-ui
Write UI in Markdown Syntax
https://github.com/jjuliano/markdown-ui
Last synced: 8 days ago
JSON representation
Write UI in Markdown Syntax
- Host: GitHub
- URL: https://github.com/jjuliano/markdown-ui
- Owner: jjuliano
- License: mit
- Created: 2015-07-14T08:25:12.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-07-26T07:57:14.000Z (4 months ago)
- Last Synced: 2024-10-28T17:14:27.061Z (11 days ago)
- Language: HTML
- Homepage: http://jjuliano.github.io/markdown-ui/
- Size: 412 KB
- Stars: 200
- Watchers: 8
- Forks: 12
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: Changelog
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- project-awesome - jjuliano/markdown-ui - Write UI in Markdown Syntax (HTML)
README
[![Join the chat at https://gitter.im/jjuliano/markdown-ui](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/jjuliano/markdown-ui?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![Code Climate](https://codeclimate.com/github/jjuliano/markdown-ui/badges/gpa.svg)](https://codeclimate.com/github/jjuliano/markdown-ui) [![Build Status](https://travis-ci.org/jjuliano/markdown-ui.svg)](https://travis-ci.org/jjuliano/markdown-ui) [![Test Coverage](https://codeclimate.com/github/jjuliano/markdown-ui/badges/coverage.svg)](https://codeclimate.com/github/jjuliano/markdown-ui/coverage) [![Gem Version](https://badge.fury.io/rb/markdown-ui.svg)](http://badge.fury.io/rb/markdown-ui)
# Markdown UI
Write UI in Markdown Syntax. See http://jjuliano.github.io/markdown-ui/
# Installation
Markdown-UI is readily available as a Ruby gem.
The minimum required Ruby version is 2.0.`$ gem install markdown-ui`
# Usage
Output is via standard out, which can be piped to create an HTML file. (Under Mac and Linux)
`$ markdown-ui index.mdui > index.html`
# Markdown-UI (Read-Evaluate-Print-Loop) REPL shell
You can interactively create Markdown-UI websites using the markdown-ui-shell.
```
$ markdown-ui-shellHit RETURN three times to parse.
# __Button|A Button__
#
#A Button
#
```# Credits
Markdown-UI would not be possible without the the [Semantic-UI](http://www.semantic-ui.com) framework, and the Ruby [RedCarpet](https://github.com/vmg/redcarpet) library. A huge thanks and credit goes to the people behind these wonderful framework and libraries.
# Notes/Issues/Bugs
* Ongoing support for Semantic-UI elements/modules/components
* The Colon (:) character will be parsed when used inside a text, needs post-processing to dislay correctly (for URLs)
* A separator in between two spaces is required on block elements to separate elements (see Column example)
* Some elements requires custom javascripts (ie toggle button) in order to display and format them properly. You can write in HTML and Javascripts the additional code alongside your Markdown-UI docs to display them properly.## Contributing
1. Fork it ( https://github.com/jjuliano/markdown-ui/fork )
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create a new Pull Request