4.0.0 (#42)

* adding URL conversions * updating gotenberg version in documentation * pkg: input as variadic string (#39) * pkg: input as variadic string * pkg: fix link to github doc * update doc about v4 client * make doc * fixing missing variadic inputs in doc * adding more fonts * updating PHP documentation
2026-08-16 04:12:16 +01:00 · 2019-01-28 15:18:12 +01:00
parent a3cd1ff4e1
commit 25f7ba3ee6
37 changed files with 553 additions and 103 deletions
--- a/build/docs/content/04-markdown.md
+++ b/build/docs/content/04-markdown.md
@@ -0,0 +1,70 @@
+---
+title: Markdown
+---
+
+Gotenberg provides the endpoint `/convert/markdown` for Markdown conversions.
+
+It accepts `POST` requests with a `multipart/form-data` Content-Type.
+
+## Basic
+
+Markdown conversions work the same as HTML conversions.
+
+Only difference is that you have access to the Go template function `toHTML`
+in the file `index.html`. This function will convert a given markdown file to HTML.
+
+For instance:
+
+```html
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>My PDF</title>
+  </head>
+  <body>
+    {{ toHTML .DirPath "file.md" }}
+  </body>
+</html>
+```
+
+### cURL
+
+```bash
+$ curl --request POST \
+    --url http://localhost:3000/convert/markdown \
+    --header 'Content-Type: multipart/form-data' \
+    --form files=@index.html \
+    --form files=@file.md \
+    -o result.pdf
+```
+
+### Go
+
+```golang
+import "github.com/thecodingmachine/gotenberg/pkg"
+
+func main() {
+    c := &gotenberg.Client{Hostname: "http://localhost:3000"}
+    req, _ := gotenberg.NewMarkdownRequest("index.html", "file.md")
+    dest := "result.pdf"
+    c.Store(req, dest)
+}
+```
+
+### PHP
+
+```php
+use TheCodingMachine\Gotenberg\Client;
+use TheCodingMachine\Gotenberg\DocumentFactory;
+use TheCodingMachine\Gotenberg\MarkdownRequest;
+
+$client = new Client('http://localhost:3000', new \Http\Adapter\Guzzle6\Client());
+$index = DocumentFactory::makeFromPath('index.html', 'index.html');
+$markdowns = [
+    DocumentFactory::makeFromPath('file.md', 'file.md'),
+];
+$request = new MarkdownRequest($index, $markdowns);
+$dest = "result.pdf";
+$filename = $client->store($request, $dest);
+```