Clear facts, practical guides, and material insights for apparel, accessories, and everyday gear. / 2026-03-14T00:00:00Z /meta/roadmap/ 2026-03-14T00:00:00Z Janus-MD

Tracking the development milestones of this site.

<p>A demo of <strong>task status markers</strong> in a nested article path (<code>articles/meta/roadmap.md</code> → <code>/meta/roadmap/</code>).</p> <h2 id="phase-1-foundation">Phase 1 — Foundation</h2> <ul> <li><span class="task-marker task-done" title="已完成">[x]</span> Set up Janus-MD template</li> <li><span class="task-marker task-done" title="已完成">[x]</span> Configure GitHub Actions CI/CD</li> <li><span class="task-marker task-done" title="已完成">[x]</span> Connect custom domain</li> </ul> <h2 id="phase-2-content">Phase 2 — Content</h2> <ul> <li><span class="task-marker task-wip" title="进行中">[-]</span> Write introductory series (3/5 done)</li> <li><span class="task-marker task-todo" title="未开始">[ ]</span> Create tutorials section</li> <li><span class="task-marker task-todo" title="未开始">[ ]</span> Add tag index pages</li> </ul> <h2 id="phase-3-enhancement">Phase 3 — Enhancement</h2> <ul> <li><span class="task-marker task-todo" title="未开始">[ ]</span> Full-text search (Fuse.js)</li> <li><span class="task-marker task-blocked" title="阻塞中">[!]</span> Image optimization pipeline — blocked by CDN decision</li> <li><span class="task-marker task-deferred" title="延后/放弃">[~]</span> Comments system — decided against to keep it static</li> </ul> /welcome/ 2026-03-14T00:00:00Z Janus-MD

A dual-state static site template — HTML for humans, Markdown for AI.

<p>This is your first article. Delete it and start writing your own.</p> <p><strong>Janus-MD</strong> generates two versions of every article:</p> <ul> <li><code>/&lt;slug&gt;/index.html</code> — rendered HTML for browsers</li> <li><code>/&lt;slug&gt;.md</code> — raw Markdown for AI agents &amp; tools</li> </ul> <h2 id="task-status-markers">Task Status Markers</h2> <p>Use these markers anywhere in your Markdown to track work:</p> <ul> <li><span class="task-marker task-todo" title="未开始">[ ]</span> This task has <strong>not started</strong> yet</li> <li><span class="task-marker task-wip" title="进行中">[-]</span> This task is <strong>in progress</strong></li> <li><span class="task-marker task-done" title="已完成">[x]</span> This task is <strong>done</strong></li> <li><span class="task-marker task-blocked" title="阻塞中">[!]</span> This task is <strong>blocked</strong></li> <li><span class="task-marker task-deferred" title="延后/放弃">[~]</span> This task is <strong>deferred or abandoned</strong></li> </ul> <p>They render as styled inline badges and are preserved verbatim in <code>.md</code> output.</p> <h2 id="nested-articles">Nested Articles</h2> <p>Place articles in subdirectories for organized content:</p> <div class="codehilite"><pre><span></span><code>articles/ 2026/ 03/ my-post.md → /2026/03/my-post/ tutorials/ getting-started.md → /tutorials/getting-started/ </code></pre></div> <h2 id="emoji-support">Emoji Support 🚀</h2> <p>Janus-MD converts emoji shortcodes at build time — no JavaScript required:</p> <ul> <li>✅ Build-time conversion — zero runtime cost</li> <li>📚 Extensive library — standard GitHub/Slack shortcodes</li> <li>✨ Works everywhere — pure Unicode output</li> </ul> <p>Examples: ❤️ 🔥 🎉 ⚠️ 💡 ⚡️</p> <p>Full shortcode reference: <a href="https://github.com/ikatyang/emoji-cheat-sheet">emoji-cheat-sheet</a></p> <h2 id="math-rendering">Math Rendering</h2> <p>Janus-MD supports LaTeX math via MathJax, loaded on-demand only when formulas are present.</p> <p>Inline math: The energy-mass equivalence <span class="arithmatex">\(E = mc^2\)</span> is fundamental to physics.</p> <p>Display math:</p> <div class="arithmatex">\[ \int_{-\infty}^{\infty} e^{-x^2} \, dx = \sqrt{\pi} \]</div> <p>The quadratic formula:</p> <div class="arithmatex">\[ x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a} \]</div> <h2 id="code-highlighting">Code Highlighting</h2> <div class="codehilite"><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">greet</span><span class="p">(</span><span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span> <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;Hello, </span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s2">!&quot;</span> <span class="nb">print</span><span class="p">(</span><span class="n">greet</span><span class="p">(</span><span class="s2">&quot;Janus&quot;</span><span class="p">))</span> </code></pre></div> <h2 id="wiki-links-obsidian-compatible">Wiki Links (Obsidian-compatible)</h2> <p>Link to other articles using Obsidian syntax:</p> <ul> <li><a href="/meta/roadmap/">Project Roadmap</a> — with display title</li> <li><a href="/welcome/">welcome</a> — without display title</li> </ul> <h2 id="next-steps">Next Steps</h2> <ul> <li><span class="task-marker task-done" title="已完成">[x]</span> Clone the template</li> <li><span class="task-marker task-wip" title="进行中">[-]</span> Edit <code>janus.config.toml</code> with your site info</li> <li><span class="task-marker task-todo" title="未开始">[ ]</span> Write your first article in <code>articles/</code></li> <li><span class="task-marker task-todo" title="未开始">[ ]</span> Push to GitHub and watch CI build your site</li> <li><span class="task-marker task-todo" title="未开始">[ ]</span> Configure DNS and enjoy your dual-state site</li> </ul>