michael/swift-mhoush.com
Archived
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: Ports all existing articles and images.

Browse Source
This commit is contained in:
Michael Housh
2025-02-20 12:14:09 -05:00
parent e0fb6129ad
commit 67dc3540d6
151 changed files with 10413 additions and 1631 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
deploy/articles/2023/you-should-learn-markdown/index.html
View File

@@ -68,25 +68,25 @@ converted to other formats, such as html, pdf, docx, and many more. All..." name
<img alt="banner" src="http://localhost:3000/articles/images/2023-10-21-you-should-learn-markdown.png"/>
<p>This is a quick article about why you should learn markdown.</p>
<h2>What is markdown</h2>
<p>Markdown is a “mark-up” language. It allows you to write content in plain text that can be easily<br />
converted to other formats, such as <strong>html, pdf, docx</strong>, and many more. All the articles written on<br />
<p>Markdown is a “mark-up” language. It allows you to write content in plain text that can be easily
converted to other formats, such as <strong>html, pdf, docx</strong>, and many more. All the articles written on
this website are written in markdown, here’s an image of this article written in markdown.</p>
<p><img src="/articles/images/2023-10-21-markdown.png" alt="markdown" /></p>
<p>The reason you should learn markdown is that it allows you to focus on the content / text of your<br />
content with simple concepts for formatting. Markdown is used heavily in documenting software<br />
projects, which is how I got introduced to it, however it can scale all the way up to writing<br />
<p>The reason you should learn markdown is that it allows you to focus on the content / text of your
content with simple concepts for formatting. Markdown is used heavily in documenting software
projects, which is how I got introduced to it, however it can scale all the way up to writing
research papers or even books.</p>
<p>I use markdown for probably 80% of all the text documents I need to write, from company documents,<br />
web / software documentation, and so on. It allows me to get content out quickly without having to<br />
click around with formatting options in a program like <strong>Word</strong> or <strong>Pages</strong>. To be clear, a lot of<br />
the reports and things I generate for my <strong>Home Performance Assessments</strong> are written using<br />
<strong>Pages</strong> (for now at least) because I have templates that make the documents look more<br />
<p>I use markdown for probably 80% of all the text documents I need to write, from company documents,
web / software documentation, and so on. It allows me to get content out quickly without having to
click around with formatting options in a program like <strong>Word</strong> or <strong>Pages</strong>. To be clear, a lot of
the reports and things I generate for my <strong>Home Performance Assessments</strong> are written using
<strong>Pages</strong> (for now at least) because I have templates that make the documents look more
professional, however I am working on solutions to migrate those to be markdown based.</p>
<p>Markdown is supported in mostly all the <strong>Google</strong> tools, as well as the <strong>Outlook</strong> email client<br />
(which is one of my least favorite tools, BTW). It makes it simple to create tables, lists, and many<br />
<p>Markdown is supported in mostly all the <strong>Google</strong> tools, as well as the <strong>Outlook</strong> email client
(which is one of my least favorite tools, BTW). It makes it simple to create tables, lists, and many
common document related tasks.</p>
<h2>Resources</h2>
<p>You can learn more about the syntax used for markdown at<br />
<p>You can learn more about the syntax used for markdown at
<a href="https://www.markdownguide.org/basic-syntax/">markdownguide.org</a>.</p>
<h3>A non-exhaustive list of where you can use Markdown and editors.</h3>
<table>
@@ -118,7 +118,7 @@ common document related tasks.</p>
<p>You can use tools such as <a href="https://pandoc.org/#">pandoc</a> to convert Markdown files to other formats.</p>
<p><img src="/articles/images/2023-10-21-pandoc.gif" alt="pandoc" /></p>
<h2>Conclusion</h2>
<p>I hope that you take the time to research and see if Markdown is good fit for your document /<br />
<p>I hope that you take the time to research and see if Markdown is good fit for your document /
content creation.</p>
<p>Thanks for reading until the end!</p>
</article>
@@ -155,7 +155,6 @@ Programming, Home-Performance, and Building Science
</div>
<p>
<a href="/articles/2025/vapor-htmx-todo-app/"><div>
<img alt="banner" src="http://localhost:3000/articles/images/2025-01-05-vapor-htmx-todo-app.png"/>
Build an example application using Vapor and HTMX.
</div></a>
</p>
@@ -169,7 +168,6 @@ Programming, Home-Performance, and Building Science
</div>
<p>
<a href="/articles/2024/free-as-in-freedom/"><div>
<img alt="banner" src="http://localhost:3000/articles/images/2024-04-09-free-as-in-freedom.png"/>
Salute to open-source software engineers
</div></a>
</p>
@@ -200,6 +198,12 @@ Programming, Home-Performance, and Building Science
|
<a href="mailto:michael@mhoush.com" rel="nofollow">Email</a>
</p>
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-core.min.js">
</script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/plugins/keep-markup/prism-keep-markup.min.js">
</script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/plugins/autoloader/prism-autoloader.min.js">
</script>
</div>
</body>
</html>