Conlang Documentation

This article is a stub. If you can contribute to its content, feel free to do so.

This page offers strategies for documenting your conlang as well as tools for doing so.

All conlangs start out as rough outlines, perhaps a single page with a hastily scribbled phonology table and a few inflectional paradigms. These are called sketchlangs. Many, if not most, will never go beyond this stage. That's not a bad thing. However, if you intend to keep working on a language long-term, you need to develop a systematic way of writing documentation. There are at least two, and preferably three, things you'll need to keep track of: Your grammar, Your lexicon, and example texts, which may be separate or may be integrated into the other two documents.

You can use any word processor or text editor for the grammar, but keep in mind that file formats can be deprecated and software isn't supported forever. Whatever you use should be able to produce headings to organize the document into sections for phonology, syntax, etc. and tables to illustrate inflectional paradigms or example glosses. It goes without saying it should also be able to render whatever characters you've chosen for your Romanization. Markdown is particularly suitable for this task, as the bare markup is intended to be presentable as-is without being rendered, and it supports both headings and (in most dialects) tables. You can write a plaintext document in Markdown and use any number of converters to render it as HTML, PDF, etc. Whatever you use, make sure it can be converted into other formats in the event you change platforms or otherwise lose access to the software.

For the lexicon, many conlangers use a spreadsheet application like Excel, Google Sheets, LibreOffice Calc, etc. It's a good idea to organize it like a dictionary, with columns for the lemma, part of speech, definition, and, if you care to, etymology. Most of these programs allow you to filter columns to search for a particular word or definition. However, spreadsheets make it hard for you to write lengthy definitions or usage notes.

If you want to be more verbose but still have the ability to look up entries easily later, a personal wiki is a good alternative. It has the additional advantages of linking between entries to reference other terms in etymologies or derivative terms. Obsidian is a good choice since it stores notes as individual Markdown files, though keep in mind that certain minutia of how it operates makes it hard to use diacritics in file names or use a case-sensitive Romanization as is done with Klingon.

TiddlyWiki is great if you want to share your work online. It's a single monolithic HTML file that can be uploaded to a bare-bones hosting service like Neocities. It's naming scheme for articles is case-sensitive, and it's very customizable if you're willing to endure a steep learning curve. And if you really want to, there are always full wikis like Dokuwiki or Mediawiki (which is what FrathWiki uses).

Whatever you end up using, write as though you have an audience. A language is a complex system, and can quickly become a BlackBox even to you if you take a long break and come back later. Use complete sentences, and make lots of example texts to illustrate grammatical features.