https://github.com/dozro/simple-pandoc-server
A simple pandoc server
https://github.com/dozro/simple-pandoc-server
pandoc
Last synced: 5 months ago
JSON representation
A simple pandoc server
- Host: GitHub
- URL: https://github.com/dozro/simple-pandoc-server
- Owner: dozro
- License: other
- Created: 2025-10-25T13:28:10.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2026-01-16T06:33:35.000Z (6 months ago)
- Last Synced: 2026-02-07T15:56:16.869Z (5 months ago)
- Topics: pandoc
- Language: Go
- Homepage:
- Size: 160 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
# simple pandoc server
[](https://github.com/dozro/simple-pandoc-server/actions/workflows/dependabot/dependabot-updates)
[](https://github.com/dozro/simple-pandoc-server/actions/workflows/docker-publish.yml)
[](https://github.com/dozro/simple-pandoc-server/actions/workflows/go-lint-test-vet.yml)
simple-pandoc-server is a lightweight HTTP server wrapper for Pandoc that allows document conversions via API-calls.
## Motivation
an easy way to convert files saved in latex for example to html for presentation in Gitea.
A guide on how to do this using this service can be found over in the [Wiki](https://github.com/dozro/simple-pandoc-server/wiki/Use-as-Renderer-for-Gitea).
## building
*for the latest building guide see the [Wiki](https://github.com/dozro/simple-pandoc-server/wiki/building)*
### build using go-task
#### Requirements
- having [Go Task](https://taskfile.dev/docs/installation) installed with version 3 or newer
- having [Go](https://go.dev/dl/) installed with version 1.24 or newer
- having [pandoc](https://pandoc.org/installing.html) installed
#### Guide
Clone the repository at or after [PR #4](https://github.com/dozro/simple-pandoc-server/pull/4) was merged (for Task support) and make sure you have Task installed.
The Taskfile is defined in the [Taskfile.yml](./Taskfile.yml).
Then run
```sh
task
```
It will build the application to `out/simple-pandoc-server`. Simply run this executable and there you go.
### build using docker
If you have Task installed (see the point above) then you can run
```sh
# to build the docker image (it will be named sps)
# TODO: make the naming dependent on env variables
task docker-build
# to build and run the docker image
task docker-run
```
If you don't have Task installed you can build the docker container by yourself using the [Dockerfile](./Dockerfile).
```sh
docker build -t sps .
```