Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Quick markdown what you need, just via a link.

Project description

qkmd

Quick markdown what you need, just via a link.

Getting Started

Have you ever try to stored the link(URL) in .txt to browse it one day later or few months after? But when you open the file again, muttering to yourself 'What do I store for this?'

Have you learn markdown syntax, but get bored to use it to record the link(URL) by press the [] and () ?

The qkmd is for you, you can just give it a link(URL) then the webpage title will be extract, format to a [title](http://example.com) pattern. Also you can customize the title what you like, append timestamp, append code snip ...

Prerequisites

If you live in the resource blocked area or Internet censorship area , please consider setting a proxy first.

  1. Install the porxy software, assure you can use browser to open the webpage

  2. Install polipo

    $ ## Ubuntu / Debian
    $ sudo apt-get update
    $ sudo apt-get install polipo
    
    $ ## redhat / CentOS
    

    Polipo installation instructions

  3. Export the proxy

    export https_proxy=http://127.0.0.1:8123
    export http_proxy=http://127.0.0.1:8123
    

The qkmd default proxy port number is 8123.

Installing

Assure you python version is >= 3.4

$ pip install qkmd

or

$ python3 setup.py install

or

$ python setup.py install

Usage

usage: qkmd.py [-h] [-d] [-v] [-c [comment [comment ...]]] [-l language]
               [-s source-code-file] [-C] [-t [title [title ...]]]
               [-o output-file] [-P]
               [link]

Quickly formatting markdown `link`, convenient your daily life/work.

positional arguments:
  link                  generate the markdown format link

optional arguments:
  -h, --help            show this help message and exit
  -d, --date            append `RFC 2822` date format
  -v, --version         display current version of `qkmd`
  -c [comment [comment ...]], --comment [comment [comment ...]]
                        give the link a simple comment
  -l language, --language language
                        specific the code language
  -s source-code-file, --source source-code-file
                        give the source code snip file
  -C, --color           source code syntax hightline
  -t [title [title ...]], --title [title [title ...]]
                        add title manually
  -o output-file, --save output-file
                        save the markdown to a file
  -P, --print           turn off print the markdown format in screen

Here is a simple way to reduce your time and simplify your operation.
Assure you always want to store the file to $HOME/mark.md and highlight the code

alias mark='function mark(){ qkmd $* -o ~/mark.md -C;}; mark'

Authors

License

  • This project is licensed under the MIT License - see the LICENSE file for details

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for qkmd, version 1.0.3
Filename, size File type Python version Upload date Hashes
Filename, size qkmd-1.0.3-py3-none-any.whl (7.4 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size qkmd-1.0.3.tar.gz (6.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page