Typemill: A Flat File CMS with a User-Friendly Markdown Editor

Typemill CMS is designed to simplify content creation with its intuitive and feature-rich Markdown editor. Whether you're a beginner or an experienced Markdown user, Typemill offers a variety of flexible options to create exceptional content effortlessly, making it an ideal solution for managing and publishing content using Markdown.

The Markdown Editor

Typemill offers two editor options: the Visual Block Editor and the Raw Markdown Editor. Authors can easily switch between the two using a button in the publish bar. You can also set a default editor in the system settings, allowing you to tailor the editing experience to your preferences.

The Visual Block Editor

This editor is ideal for authors who prefer a WYSIWYG (What You See Is What You Get) experience. The visual mode allows you to edit individual content blocks, which are automatically converted to HTML upon saving. Unlike a standard live preview, this approach offers additional advantages, such as the ability to effortlessly rearrange blocks using drag-and-drop. It also supports the integration of non-Markdown elements, like embedding blocks or math syntax, which seamlessly blend into the HTML preview.

Screenshot of the visual markdown editor

Highlights:

  • Drag and Drop: Rearrange content blocks with ease.
  • Simplified Table and Definition List Editing: Intuitively manage complex elements like tables and definition lists.
  • Multimedia Integration: Quickly insert images, videos, and files using the built-in uploader.
  • HTML Preview: Instantly view the HTML output of your Markdown content for accurate formatting.

The Raw Markdown Editor

This editor is perfect for those who prefer direct control or need to make precise edits. The mode is also useful for copy-paste content, or restructure text.

Screenshot of the raw markdown editor

Highlights:

  • Dark Mode: Enhanced readability and reduced eye strain.
  • Syntax Highlighting: View Markdown formatting with integrated syntax highlighting.
  • Advanced Editing: Ideal for fine-tuning Markdown output and restructuring text.

Typemill's dual-editor approach ensures a seamless experience for all users, whether you prefer visual editing or raw Markdown control.

The Markdown Syntax

Typemill supports all core elements of the Markdown specification, enabling seamless content creation and formatting. It extends this functionality with Markdown Extra syntax, offering additional flexibility and features for your writing.

Standard Markdown Elements

Typemill fully supports the following standard Markdown features:

  • Paragraphs
  • Bold
  • Italic
  • Strikethrough
  • Unordered lists
  • Ordered lists
  • Inline links
  • Reference-style links
  • Images
  • Blockquotes
  • Inline code
  • Code blocks
  • Horizontal lines

Markdown Extra Features

In addition to the standard Markdown elements, Typemill supports Markdown Extra, providing advanced capabilities for structured content:

  • Tables
  • Definition lists
  • Footnotes
  • Markdown inside HTML blocks
  • Fenced code blocks
  • Abbreviations
  • Automatic URL linking
  • Special attributes

Additional Content, HTML, and Shortcodes

Typemill's editor is highly flexible and supports elements beyond Markdown. Out of the box, it includes the following features:

  • Automatic Table of Contents (ToC)
  • Audio files
  • Video files
  • Notices

The editor can also be enhanced with plugins and shortcodes, enabling authors to integrate a wide range of content and advanced features. Examples include:

  • Math syntax via the math plugin
  • Diagrams using the mermaid plugin
  • HTML elements with the html plugin
  • Embedded content through the embed plugin

Markdown Files

Typemill stores all content as plain text Markdown files, structured according to the website’s navigation. This makes it easy to back up content using FTP or integrate it with version control systems like Git. You can also use external Markdown editors to create content and then move the plain text Markdown files into Typemill's content folder; however, you’ll need to recreate the navigation manually using the Kixote interface to ensure proper integration.