Swiftpack.co - Package - IBM-Swift/Kitura-Markdown


APIDoc Build Status - Master macOS Linux Apache 2 Slack Status


A templating engine for Kitura that uses Markdown-based templates.

Kitura-Markdown enables a Kitura server to serve HTML content generated from Markdown templates (.md files).

Markdown File

Markdown is a lightweight markup language with plain text formatting syntax. Mastering Markdown provides documentation and examples on how to write Markdown files. By default the Kitura Router will look in the Views folder for Markdown files with the extension .md.


Add dependencies

Add the Kitura-Markdown package to the dependencies within your application’s Package.swift file. Substitute "x.x.x" with the latest Kitura-Markdown release.

.package(url: "https://github.com/IBM-Swift/Kitura-Markdown.git", from: "x.x.x")

Add KituraMarkdown to your target's dependencies:

.target(name: "example", dependencies: ["KituraMarkdown"]),

Import package

import KituraStencil


The following example takes a server generated using kitura init and modifies it to serve Markdown-formatted text from a .md file.

The files which will be edited in this example, are as follows:

├── Package.swift
├── Sources
│    └── Application
│         └── Application.swift
└── Views
     └── Example.md

The Views folder and Example.md file will be created later on, since they are not initialized by kitura init.


Add the dependencies to your Package.swift file (as defined in Add dependencies above).


Inside the Application.swift file, add the following code to render the Example.md template file on the "/docs" route.

import KituraMarkdown

Add the following code inside the postInit() function:

router.add(templateEngine: KituraMarkdown())
router.get("/docs") { _, response, next in
    try response.render("Example.md", context: [String:Any]())


Create the Views folder and put the following Markdown template code into a file called Example.md:

It's very easy to make some words **bold** and other words *italic* with Markdown. You can even [link to Kitura](https://github.com/IBM-Swift/Kitura) and write code examples:
`print("Hello world!")`

When the server is running, go to http://localhost:8080/docs to view the rendered Markdown template.

API documentation

For more information visit our API reference.


We love to talk server-side Swift, and Kitura. Join our Slack to meet the team!


This library is licensed under Apache 2.0. Full license text is available in LICENSE.


Stars: 19
Help us keep the lights on


1.1.0 - May 22, 2018

  • Support Codable render

1.0.0 - Mar 1, 2018

  • Update embedded cmark dependency from 0.25.2 to 0.28.3 (#10, #11)
    • release notes available at https://github.com/commonmark/cmark/releases
  • Support Swift 4.1
  • Usage examples added to README

0.9.1 - Sep 12, 2017