Skip to main content

pandoc filters to render svgbob diagrams

Project description


Pandoc filter to render svgbob


This filter requires svgbob and rsvg-convert in $PATH


install by pip-git:

$ pip3 install git+


Reference svgbob help (svgbob --help)

svgbob 0.3.2
SvgBobRus is an ascii to svg converter

    svgbob [FLAGS] [OPTIONS] [input] [SUBCOMMAND]

    -h, --help       Prints help information
    -s               parse an inline string
    -V, --version    Prints version information

        --font-family <font-family>      text will be rendered with this font (default: 'arial')
        --font-size <font-size>          text will be rendered with this font size (default: 14)
    -o, --output <output>                where to write svg output [default: STDOUT]
        --scale <scale>                  scale the entire svg (dimensions, font size, stroke width) by this factor
                                         (default: 1)
        --stroke-width <stroke-width>    stroke width for all lines (default: 2)

    <input>    svgbob text file or inline string to parse [default: STDIN]

    build    Batch convert files to svg.
    help     Prints this message or the help of the given subcommand(s)

Filter options inherits options for svgbob itself. They are applied as attributes or preset by setting metadata

Filter option yaml metadata Description default value
font-family svgbob.font-family Text will be rendered with this font "Arial"
font-size svgbob.size text will be rendered with this font size 14
scale svgbob.scale scale the entire svg (dimensions, font size, stroke width) by this factor 1
stroke-width svgbob.stroke-width stroke width for all lines 2

Sample Markdown

# YAML frontmatter
  font-family: "Source Code Pro"
#  font-size: 12
#  scale: 2
#  stroke-width: 3

[Example](bob.bob){.svgbob font-size=14 stroke-width=2 scale=3}

Example{.svgbob font-size=14 stroke-width=2 scale=3}

Usage example

pandoc -F pandoc-svgbob-filter -o README.html

Build svgbob binary (when updated)

$ git clone
$ cd pandoc-svgbob-filter
$ make svgbob
# builds binary under "svgbob" directory

Project details

Download files

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

Source Distribution

pandoc_svgbob_filter-0.0.3.tar.gz (3.5 MB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page