Why I Keep My Website Markdown-First
A sample note on writing in plain text files and publishing through Git. Replace with your own article.
By Kshitiz Baral Published Updated 1 min read
This is a sample article. Delete it or rewrite it.
Plain text files last. A Markdown article written today will open in any editor in ten years, and it travels easily between tools.
What Markdown gives me
- Content separated from design
- Version history through Git
- Publishing by adding one file
The workflow
Write the article, save it in src/content/blog/, commit, and push. The site rebuilds and the article appears in the listing, the search index and the RSS feed.
What I would still check
Before publishing, read the article once on a phone. Long tables and code blocks are the usual trouble spots.
Tagged: Markdown, Writing, Tools