Ⓜ️⬇️ Markdown - The Most Important Tool In My Toolbox

Sep 05, 2024 10:00 am

Hey Friends 👋,


As a software developer myself, I've found that markdown is the most important tool in my toolbox. It's the glue that holds everything together. It's the key to keeping my projects organized and on track. Every day, I interact with people who build, use, maintain, support or manage the software my team builds. Markdown is the syntax that allows us to record and communicate important information about the software we build. And because it's a content first format, it's the perfect tool for the job. We use markdown to write user guides, support docs and readme's. We use it in our pull requests, issues, slack messages and even in our code comments. When we have to write something that stakeholders need to access, we write it in a markdown file and publish it to Confluence. If Confluence isn't available, we still have our source code and markdown files in our source code.


I first got acquainted with markdown when I created an account on github in 2010. At the time, I was the software development manager for LandsEnd.com. It was a waterfall IT shop with a few of us starting to advocate for an agile transformation. During peak season, I spent most of my days with business and IT stakeholders in planning meetings. At then end of the day, I had to compile my notes into tasks I had to accomplish in order to plan and schedule resources or provide estimates for the work. I experimented with too many note taking and task management systems to name, but nothing really saved me that much time. That's when I came up with the idea to take notes in markdown and use TODO comments to create a kanban board. The year was 2011.

Since then, I gradually used markdown more and more in my work while the community and market provided tons of tools to make it more versatile and easy to maintain. So I've chosen to double down on markdown, because it looks like it's here to stay.


Here are a few of my favorite markdown tools:


  1. Imdone - A kanban board that uses markdown files on your filesystem to manage your work.
  2. Markdown Here - A browser extension that lets you write emails in markdown.
  3. Markdown All in One - A Visual Studio Code extension that provides a ton of features for working with markdown.


You can find more at markdownguide.org/tools


☑️ Imdone for now 😜 - Jesse


P.S. Check out my Youtube channel: https://www.youtube.com/@JessePiascik

Comments