/markdownpy

Easy Markdown Web Server in Python/Flask

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Markdown easy served as HTML

Open source Python3 + Flask + Markdown

Easy installation

After "download" or "git clone" this project, do:

$ python3 -m venv venv
$ pip install -r requirements.txt

On windows, use: python -m venv venv

If markdown library can't be found when you are starting the server, try:

    $ rm -r ./venv
    $ python -m venv venv
    $ pip install markdown
    $ pip install flask

Start the server

$ source ./venv/bin/activate
$ flask --debug run --host 0.0.0.0 --port 8080 --reload

On windows, use: venv\Scripts\activate.bat

Remember, on linux you must to use "sudo" to bind on low ports. 
You could use --port 5000 instead.

Access the url with a browser:

http://127.0.0.1:5009
http://127.0.0.1
http://127.0.0.1/api/
http://127.0.0.1/view/
http://127.0.0.1/raw/filename.png

Docker Container

https://hub.docker.com/repository/docker/lmldocker/markdownpy/general

docker run -it --rm -p 8080:8080 lmldocker/markdownpy:1.0

or

docker run -d -p 8080:8080 \
-v /area6/docker/volume/markdownpy/data:/area6/python/dev/markdownpy/data \
-v /area6/docker/volume/markdownpy/resources:/area6/python/dev/markdownpy/resources \
lmldocker/markdownpy:1.0

The server runs on --reload mode!

KUBERNETES

kubectl run markdownpy --image=lmldocker/markdownpy:1.1 --restart='Always' --port=8080 --dry-run=client -o yaml

kubectl apply -f markdownpy.yaml

apiVersion: v1 kind: Pod metadata: labels: run: markdownpy name: markdownpy spec: containers:

  • image: lmldocker/markdownpy:1.1 name: markdownpy ports:
    • containerPort: 8080

kubectl expose pod markdownpy --name=markdownpy-svc --type=NodePort --port=8888 --dry-run=client -o yaml

apiVersion: v1 kind: Service metadata: labels: run: markdownpy name: markdownpy-svc spec: ports:

  • port: 8888 protocol: TCP targetPort: 8888 selector: run: markdownpy type: NodePort

k exec -ti pod/markdownpy -- sh

Authors

Leonardo M Labolida (Spain/Brasil)
Tomás R Pita        (Spain/Venezuela)

Donation

Buy Me a Coffee at ko-fi.com