<?xml version="1.0" encoding="utf-8"?>
<?xml-stylesheet href="https://codedchords.dev/feed_style.xsl" type="text/xsl"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
    <tabi:metadata xmlns:tabi="https://github.com/welpo/tabi">
        <tabi:base_url>https:&#x2F;&#x2F;codedchords.dev</tabi:base_url>
        <tabi:separator>
            •
        </tabi:separator>
        <tabi:about_feeds>This is a web feed, also known as an Atom feed. Subscribe by copying the URL from the address bar into your newsreader. Visit About Feeds to learn more and get started. It&#x27;s free.</tabi:about_feeds>
        <tabi:visit_the_site>Visit website</tabi:visit_the_site>
        <tabi:recent_posts>Recent posts</tabi:recent_posts>
        <tabi:last_updated_on>Updated on $DATE</tabi:last_updated_on>
        <tabi:default_theme></tabi:default_theme>
        <tabi:post_listing_date>date</tabi:post_listing_date>
        <tabi:current_section>Documentation</tabi:current_section>
    </tabi:metadata><title>Coded Chords - Documentation</title>
        <subtitle>A personal blog</subtitle>
    <link href="https://codedchords.dev/tags/documentation/atom.xml" rel="self" type="application/atom+xml"/>
    <link href="https://codedchords.dev/tags/documentation/" rel="alternate" type="text/html"/>
    <generator uri="https://www.getzola.org/">Zola</generator><updated>2026-07-10T05:00:00+09:00</updated><id>https://codedchords.dev/tags/documentation/atom.xml</id><entry xml:lang="en">
        <title>技術文書用フォーマット AsciiDoc</title>
        <published>2026-07-10T05:00:00+09:00</published>
        <updated>2026-07-10T05:00:00+09:00</updated>
        <author>
            <name>Toshiyuki Yoshida</name>
        </author>
        <link rel="alternate" href="https://codedchords.dev/blog/2026/07/asciidoc/" type="text/html"/>
        <id>https://codedchords.dev/blog/2026/07/asciidoc/</id>
        
            <content type="html">&lt;!-- textlint-disable --&gt;
&lt;img
  src=&quot;https:&amp;#x2F;&amp;#x2F;codedchords.dev&amp;#x2F;blog&amp;#x2F;2026&amp;#x2F;07&amp;#x2F;asciidoc&amp;#x2F;cover.webp?h=2af306a0693c3ee09dbc&quot;
  alt=&quot;Cover&quot; width=&quot;1536&quot; height=&quot;864&quot; loading=&quot;lazy&quot;
&#x2F;&gt;&lt;!-- textlint-enable --&gt;
&lt;details&gt;
&lt;summary&gt;Table of Contents&lt;&#x2F;summary&gt;
&lt;!-- toc --&gt;
&lt;&#x2F;details&gt;
&lt;span id=&quot;continue-reading&quot;&gt;&lt;&#x2F;span&gt;
&lt;p&gt;AsciiDocで書かれたドキュメントを修正する必要があったので、
AsciiDoctorを導入しました。&lt;&#x2F;p&gt;
&lt;h2 id=&quot;AsciiDocとは&quot;&gt;AsciiDocとは&lt;&#x2F;h2&gt;
&lt;p&gt;AsciiDocは、2002年にStuart Rackham氏が開発したマークアップ言語です。
もともとはDocBook XMLを人間が書きやすい記法で表現するためのPython製ツールとして
誕生しました。プレーンテキストで書いた文書を、HTMLやPDF、EPUBなど複数の形式に
変換できる点が特徴です。&lt;&#x2F;p&gt;
&lt;p&gt;2013年にはRuby実装のAsciidoctorが登場し、現在ではこちらが主流の処理系となっています。
本記事でも、AsciiDocの処理系としてAsciidoctorを使用します。&lt;&#x2F;p&gt;
&lt;p&gt;2019年からはEclipse Foundation傘下の
AsciiDoc Working Groupによって言語仕様の標準化も進められており、
処理系間の互換性が高まりつつあります。&lt;&#x2F;p&gt;
&lt;p&gt;ただし、技術文書での採用率では明確にMarkdownが優位です。
技術文書作成者の主要フォーマットとしてMarkdownを使う割合が约65%とされ、デファクトスタンダードの地位にあります。学習コストの低さとツールの豊富さ、生成AIで扱う文書形式の標準となっていることが理由です。
実際にはAsciiDocは全体の採用率では大きく水を開けられています。&lt;&#x2F;p&gt;
&lt;h2 id=&quot;MacへのAsciiDocの導入&quot;&gt;MacへのAsciiDocの導入&lt;&#x2F;h2&gt;
&lt;p&gt;AsciiDocの処理系としてAsciiDoctorを使用します。&lt;&#x2F;p&gt;
&lt;p&gt;ランタイムにRubyを使用するので、Rubyのインストールから行っています。
前提として、私の環境では
&lt;a rel=&quot;external&quot; href=&quot;https:&#x2F;&#x2F;mise.jdx.dev&quot;&gt;mise&lt;&#x2F;a&gt;で言語のバージョンを管理しています。&lt;&#x2F;p&gt;
&lt;pre class=&quot;giallo z-code&quot;&gt;&lt;code data-lang=&quot;shellscript&quot; data-name=&quot;install.sh&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation z-definition z-comment z-comment&quot;&gt;# Rubyのインストール&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-entity z-name z-function&quot;&gt;mise&lt;&#x2F;span&gt;&lt;span class=&quot;z-string&quot;&gt; use -g ruby@latest&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-entity z-name z-function&quot;&gt;gem&lt;&#x2F;span&gt;&lt;span class=&quot;z-string&quot;&gt; install asciidoctor asciidoctor-pdf asciidoctor-rouge&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-entity z-name z-function&quot;&gt;gem&lt;&#x2F;span&gt;&lt;span class=&quot;z-string&quot;&gt; install asciidoctor-pdf-cjk asciidoctor-diagram&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;&lt;&#x2F;code&gt;&lt;&#x2F;pre&gt;&lt;h2 id=&quot;AsciiDocのサンプル&quot;&gt;AsciiDocのサンプル&lt;&#x2F;h2&gt;
&lt;p&gt;似たようなマークアップ言語にMarkdownがありますが、
以下のような点でAsciiDocが優れているので作る文書の特性で
使い分けています。&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;目次や表紙の生成が可能&lt;&#x2F;li&gt;
&lt;li&gt;細かいテーブルの表現が可能&lt;&#x2F;li&gt;
&lt;li&gt;ソースコードにシンタックスハイライトや吹き出しが使える&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;p&gt;GitHubやGitLabでもネイティブでAsciiDocのレンダリングに対応しています。
始めからHTMLやPDFへの変換を意識して作られている点でも優れています。&lt;&#x2F;p&gt;
&lt;p&gt;次にサンプルを提示します。
Frontmatterを除くと、ソースのままでも読みやすい形式です。
特に今回はソースコードの解説だったので、以下の例ではソースコードへの解説を追記する例となっています。&lt;&#x2F;p&gt;
&lt;pre class=&quot;giallo z-code&quot;&gt;&lt;code data-lang=&quot;asciidoc&quot; data-name=&quot;sample.adoc&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-markup z-heading z-heading-0 z-asciidoc&quot;&gt;= サンプル&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt;toc&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-string&quot;&gt; left&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt;toc-title&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-string&quot;&gt; 目次&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt;toclevel&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-string&quot;&gt; 4&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt;imagesdir&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-string&quot;&gt; images&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt;figure-caption&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-string&quot;&gt; 図&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt;chapter-signifier&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt;scripts&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-string&quot;&gt; cjk&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt;pdf-theme&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-string&quot;&gt; default-with-font-fallbacks&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt;doctype&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-string&quot;&gt; book&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt;sectnumlevels&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-string&quot;&gt; 4&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt;sectnums&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt;source-highlighter&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-string&quot;&gt; rouge&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt;rouge-style&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-string&quot;&gt; gruvbox&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-markup z-heading z-heading-1 z-asciidoc&quot;&gt;== Hello World&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-text&quot;&gt;.hello.py&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-text&quot;&gt;[&lt;&#x2F;span&gt;&lt;span class=&quot;z-entity z-name z-function&quot;&gt;source&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;,&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt;python]&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-text&quot;&gt;----&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-support z-function z-builtin z-python&quot;&gt;print&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;(&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation z-definition z-string z-string&quot;&gt;&amp;quot;Hello World!&amp;quot;&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;)&lt;&#x2F;span&gt;&lt;span class=&quot;z-keyword z-operator&quot;&gt;  &amp;lt;&lt;&#x2F;span&gt;&lt;span class=&quot;z-constant z-numeric&quot;&gt;1&lt;&#x2F;span&gt;&lt;span class=&quot;z-keyword z-operator&quot;&gt;&amp;gt;&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-text&quot;&gt;i&lt;&#x2F;span&gt;&lt;span class=&quot;z-keyword z-operator&quot;&gt; =&lt;&#x2F;span&gt;&lt;span class=&quot;z-constant z-numeric&quot;&gt; 3&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-keyword z-control z-flow z-python&quot;&gt;if&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt; i&lt;&#x2F;span&gt;&lt;span class=&quot;z-keyword z-operator&quot;&gt; ==&lt;&#x2F;span&gt;&lt;span class=&quot;z-constant z-numeric&quot;&gt; 1&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;span class=&quot;z-keyword z-operator&quot;&gt;             &amp;lt;&lt;&#x2F;span&gt;&lt;span class=&quot;z-constant z-numeric&quot;&gt;2&lt;&#x2F;span&gt;&lt;span class=&quot;z-keyword z-operator&quot;&gt;&amp;gt;&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-support z-function z-builtin z-python&quot;&gt;  print&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;(&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation z-definition z-string z-string&quot;&gt;&amp;quot;i = 1&amp;quot;&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;)&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-keyword z-control z-flow z-python&quot;&gt;elif&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt; i&lt;&#x2F;span&gt;&lt;span class=&quot;z-keyword z-operator&quot;&gt; ==&lt;&#x2F;span&gt;&lt;span class=&quot;z-constant z-numeric&quot;&gt; 2&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-support z-function z-builtin z-python&quot;&gt;  print&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;(&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation z-definition z-string z-string&quot;&gt;&amp;quot;i = 2&amp;quot;&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;)&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-keyword z-control z-flow z-python&quot;&gt;elif&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt; i&lt;&#x2F;span&gt;&lt;span class=&quot;z-keyword z-operator&quot;&gt; ==&lt;&#x2F;span&gt;&lt;span class=&quot;z-constant z-numeric&quot;&gt; 3&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-support z-function z-builtin z-python&quot;&gt;  print&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;(&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation z-definition z-string z-string&quot;&gt;&amp;quot;i = 3&amp;quot;&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;)&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-keyword z-control z-flow z-python&quot;&gt;else&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;:&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-support z-function z-builtin z-python&quot;&gt;  print&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;(&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation z-definition z-string z-string&quot;&gt;&amp;quot;i = 4&amp;quot;&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;)&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-text&quot;&gt;----&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-text&quot;&gt;&amp;lt;1&amp;gt; やっぱりサンプルといえばコレな&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-text&quot;&gt;&amp;lt;2&amp;gt; IF文です！&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;&lt;&#x2F;code&gt;&lt;&#x2F;pre&gt;&lt;h2 id=&quot;AsciiDocを変換する&quot;&gt;AsciiDocを変換する&lt;&#x2F;h2&gt;
&lt;p&gt;作成したAsciiDocのソースは以下のコマンドでHTMLやPDFに変換します。&lt;&#x2F;p&gt;
&lt;pre class=&quot;giallo z-code&quot;&gt;&lt;code data-lang=&quot;shellscript&quot; data-name=&quot;convert.sh&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation z-definition z-comment z-comment&quot;&gt;# HTMLの生成&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-entity z-name z-function&quot;&gt;asciidoctor&lt;&#x2F;span&gt;&lt;span class=&quot;z-string&quot;&gt; --backend html5 sample.adoc -o sample.html&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation z-definition z-comment z-comment&quot;&gt;# PDFの生成&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-entity z-name z-function&quot;&gt;asciidoctor-pdf&lt;&#x2F;span&gt;&lt;span class=&quot;z-string&quot;&gt; sample.adoc -o sample.pdf&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;&lt;&#x2F;code&gt;&lt;&#x2F;pre&gt;
&lt;p&gt;以下が生成したサンプルです。&lt;&#x2F;p&gt;
&lt;!-- textlint-disable --&gt;
&lt;img
  src=&quot;https:&amp;#x2F;&amp;#x2F;codedchords.dev&amp;#x2F;blog&amp;#x2F;2026&amp;#x2F;07&amp;#x2F;asciidoc&amp;#x2F;sample.webp?h=aa551a1eddeb908ee3e0&quot;
  alt=&quot;AsciiDoc生成結果&quot; width=&quot;983&quot; height=&quot;572&quot; loading=&quot;lazy&quot;
&#x2F;&gt;&lt;!-- textlint-enable --&gt;
&lt;h2 id=&quot;まとめ&quot;&gt;まとめ&lt;&#x2F;h2&gt;
&lt;p&gt;AsciiDocは
Markdownと似ているので混乱する部分もありますが、
Markdownよりやりたいことをストレートに書けると思います。&lt;&#x2F;p&gt;
&lt;p&gt;サンプルのようにAsciiDocのメタデータにいろいろ記載すると生成するスタイルも
変更できるのでいろんな文章に柔軟に対応できると思います。&lt;&#x2F;p&gt;
</content>
        <summary type="html">ソースコードの解説を含む技術文書を書く必要があり、AsciiDocとその処理系Asciidoctorを
導入しました。Markdownが標準となった今あえてAsciiDocを選ぶ理由と、
Mac環境での導入手順、実際の変換サンプルを紹介します。
</summary>
        </entry><entry xml:lang="en">
        <title>LogSeq at a Glance: An Overview for Beginners</title>
        <published>2025-01-01T00:00:00+00:00</published>
        <updated>2025-01-01T00:00:00+00:00</updated>
        <author>
            <name>Toshiyuki Yoshida</name>
        </author>
        <link rel="alternate" href="https://codedchords.dev/blog/2025/01/logseq/" type="text/html"/>
        <id>https://codedchords.dev/blog/2025/01/logseq/</id>
        
            <content type="html"> &lt;details&gt;
  &lt;summary&gt;Table of Contents&lt;&#x2F;summary&gt;
  &lt;!-- toc --&gt;
  &lt;&#x2F;details&gt;
&lt;h2 id=&quot;はじめに&quot;&gt;はじめに&lt;&#x2F;h2&gt;
&lt;h3 id=&quot;LogSeqとは何か、シンプルな説明&quot;&gt;LogSeqとは何か、シンプルな説明&lt;&#x2F;h3&gt;
&lt;p&gt;LogSeqは、あなたの考えやアイデア、メモを自由に書き留め、それらをつなぎ合わせることができるデジタルノートアプリです。紙のノートとは違い、書いた内容を後から簡単に整理したり、関連する情報どうしをリンクでつなげたりできます。&lt;&#x2F;p&gt;
&lt;p&gt;特徴的なのは、以下の3つのポイントです。&lt;&#x2F;p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;箇条書きベースで書ける&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;考えたことを思いつくままメモできる&lt;&#x2F;li&gt;
&lt;li&gt;後から簡単に整理できる&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;日付ごとにページが自動で作られる&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;日記のように、その日のことを記録できる&lt;&#x2F;li&gt;
&lt;li&gt;カレンダーのように過去の記録を見返せる&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;ページ同士をつなげられる&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;関連する情報どうしを簡単にリンクできる&lt;&#x2F;li&gt;
&lt;li&gt;新しい気づきや発見を見つけやすい&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;&#x2F;ol&gt;
&lt;h3 id=&quot;なぜLogSeqが便利なのか&quot;&gt;なぜLogSeqが便利なのか&lt;&#x2F;h3&gt;
&lt;p&gt;LogSeqが便利な理由は、私たちの脳の働き方と合わせた設計にあります。&lt;&#x2F;p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;思考の自然な流れを妨げない&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;思いついたことを、その場でさっと書き留められる&lt;&#x2F;li&gt;
&lt;li&gt;後でどこに書いたか探すことを気にせず、まずメモできる&lt;&#x2F;li&gt;
&lt;li&gt;整理は後からでもできる&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;情報同士のつながりを自然に作れる&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;関連する情報を&lt;code&gt;[[リンク]]&lt;&#x2F;code&gt;で簡単につなげられる&lt;&#x2F;li&gt;
&lt;li&gt;一度つないだ情報は、双方向から見つけられる&lt;&#x2F;li&gt;
&lt;li&gt;気づかなかった情報のつながりが自然と見えてくる&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;記憶と振り返りをサポート&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;日付ごとのページが自動で作られるので、いつ何を考えたかが残る&lt;&#x2F;li&gt;
&lt;li&gt;過去の記録が自然とタイムライン化される&lt;&#x2F;li&gt;
&lt;li&gt;定期的な振り返りが簡単にできる&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;知識が育っていく&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;書いた内容は単なる記録として終わらない&lt;&#x2F;li&gt;
&lt;li&gt;新しい情報を追加するたびに、既存の知識とつながっていく&lt;&#x2F;li&gt;
&lt;li&gt;それによって新しい発見や気づきが生まれる&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;&#x2F;ol&gt;
&lt;p&gt;つまり、LogSeqは「とりあえずメモ」から始めて、そこから自然と「つながりのある知識」を育てていけるツールなのです。&lt;&#x2F;p&gt;
&lt;h2 id=&quot;LogSeqの基本的な使い方&quot;&gt;LogSeqの基本的な使い方&lt;&#x2F;h2&gt;
&lt;h3 id=&quot;最初の画面の見方&quot;&gt;最初の画面の見方&lt;&#x2F;h3&gt;
&lt;p&gt;LogSeqを開くと、シンプルな画面が表示されます。画面の構成を理解しましょう。&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;左側のサイドバー&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;ジャーナル（日付ごとのページ）へのリンク&lt;&#x2F;li&gt;
&lt;li&gt;お気に入りページの一覧&lt;&#x2F;li&gt;
&lt;li&gt;全てのページ一覧&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;メイン画面&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;現在の日付のページが自動で開&lt;&#x2F;li&gt;
&lt;li&gt;ここに自由に文章を書いていく&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;右側のサイドバー&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;開いているページに関連する情報が表示&lt;&#x2F;li&gt;
&lt;li&gt;リンクされているページの一覧なども表示&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;h3 id=&quot;新しいページの作り方&quot;&gt;新しいページの作り方&lt;&#x2F;h3&gt;
&lt;p&gt;新しいページを作るには2つの方法があります。&lt;&#x2F;p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;直接作成する方法&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;画面上部の検索バーに新しいページ名を入力&lt;&#x2F;li&gt;
&lt;li&gt;エンターキーを押すと、新しいページが作られる&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;リンクから作る方法&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;文章の中に&lt;code&gt;[[新しいページ名]]&lt;&#x2F;code&gt;と書く&lt;&#x2F;li&gt;
&lt;li&gt;自動的にリンクが作られ、クリックで新しいページを作られる&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;&#x2F;ol&gt;
&lt;h3 id=&quot;Markdownで記入する&quot;&gt;Markdownで記入する&lt;&#x2F;h3&gt;
&lt;p&gt;LogSeqでは、Markdownという書き方を使います。難しく考える必要はありません。
以下のような基本的な書き方を覚えましょう。&lt;&#x2F;p&gt;
&lt;p&gt;&lt;strong&gt;見出しの書き方&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;pre class=&quot;giallo z-code&quot;&gt;&lt;code data-lang=&quot;markdown&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-text&quot;&gt;大見出し&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation z-definition z-heading z-markdown z-heading z-\31  z-markdown&quot;&gt;# 中見出し&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation z-definition z-heading z-markdown z-heading z-\32  z-markdown&quot;&gt;## 小見出し&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;&lt;&#x2F;code&gt;&lt;&#x2F;pre&gt;
&lt;p&gt;&lt;strong&gt;文字の装飾&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;pre class=&quot;giallo z-code&quot;&gt;&lt;code data-lang=&quot;markdown&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation&quot;&gt;_&lt;&#x2F;span&gt;&lt;span class=&quot;z-markup z-italic&quot;&gt;斜体で書く&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;_&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation&quot;&gt;**&lt;&#x2F;span&gt;&lt;span class=&quot;z-markup z-bold&quot;&gt;太字で書く&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;**&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation&quot;&gt;~~&lt;&#x2F;span&gt;&lt;span class=&quot;z-markup z-strikethrough&quot;&gt;打ち消し線&lt;&#x2F;span&gt;&lt;span class=&quot;z-punctuation&quot;&gt;~~&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;&lt;&#x2F;code&gt;&lt;&#x2F;pre&gt;
&lt;p&gt;&lt;strong&gt;箇条書き&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;pre class=&quot;giallo z-code&quot;&gt;&lt;code data-lang=&quot;markdown&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation z-definition z-list z-begin z-markdown&quot;&gt;-&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt; 箇条書き1&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation z-definition z-list z-begin z-markdown&quot;&gt;  -&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt; 箇条書き1-1&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation z-definition z-list z-begin z-markdown&quot;&gt;  -&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt; 箇条書き1-2&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-punctuation z-definition z-list z-begin z-markdown&quot;&gt;-&lt;&#x2F;span&gt;&lt;span class=&quot;z-text&quot;&gt; 箇条書き2&lt;&#x2F;span&gt;&lt;&#x2F;span&gt;&lt;&#x2F;code&gt;&lt;&#x2F;pre&gt;
&lt;p&gt;これらの書き方は、実際に使いながら少しずつ覚えていけば大丈夫です。最初は普通の文章を書くところから始めましょう。&lt;&#x2F;p&gt;
&lt;h2 id=&quot;日々のノート作成の基本&quot;&gt;日々のノート作成の基本&lt;&#x2F;h2&gt;
&lt;h3 id=&quot;箇条書きの書き方&quot;&gt;箇条書きの書き方&lt;&#x2F;h3&gt;
&lt;p&gt;LogSeqでは、箇条書きを基本としてノートを作成します。箇条書きには、以下のような特徴があります。&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;基本の書き方&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;行頭に「-」（ハイフン）と半角スペースを入力&lt;&#x2F;li&gt;
&lt;li&gt;Enterキーを押すと、自動的に次の箇条書きが始まる&lt;&#x2F;li&gt;
&lt;li&gt;Tabキーで階層を下げる（字下げ）&lt;&#x2F;li&gt;
&lt;li&gt;Shift + Tabで階層を上げる&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;箇条書きのコツ&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;1つの項目は短めに書く&lt;&#x2F;li&gt;
&lt;li&gt;詳しい説明が必要な場合は、階層を下げて書く&lt;&#x2F;li&gt;
&lt;li&gt;関連する内容は、同じ階層にまとめる&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;h3 id=&quot;日付ページの使い方&quot;&gt;日付ページの使い方&lt;&#x2F;h3&gt;
&lt;p&gt;LogSeqでは、毎日自動的に日付のページ（ジャーナル）が作られます。&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;日付ページの特徴&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;起動時に自動的に今日の日付のページが開く&lt;&#x2F;li&gt;
&lt;li&gt;左サイドバーの「Journals」から過去の日付を開ける&lt;&#x2F;li&gt;
&lt;li&gt;日付ページには、その日に考えたことや行ったことを自由に書ける&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;効果的な使い方&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;朝：今日やることを箇条書きで書き出す&lt;&#x2F;li&gt;
&lt;li&gt;日中：気づいたことや考えたことをメモ&lt;&#x2F;li&gt;
&lt;li&gt;夜：その日の振り返りを書く&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;h3 id=&quot;タグの付け方と活用法&quot;&gt;タグの付け方と活用法&lt;&#x2F;h3&gt;
&lt;p&gt;タグは情報の整理と検索を助ける強力なツールです。ページリンクと組み合わせることで、より効果的な知識管理が可能になります。&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;タグの基本&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;単語の前に「#」（ハッシュ）を付ける&lt;&#x2F;li&gt;
&lt;li&gt;例：#勉強 #アイデア #ToDo&lt;&#x2F;li&gt;
&lt;li&gt;スペースを含む場合は「&lt;code&gt;#[[読書メモ]]&lt;&#x2F;code&gt;」のように[[]]で囲む&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;タグとページリンクの特徴と使い分け&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;タグ（#）の特徴&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;複数のページに共通する「性質」を示すのに適している&lt;&#x2F;li&gt;
&lt;li&gt;一覧表示やフィルタリングが簡単&lt;&#x2F;li&gt;
&lt;li&gt;例：#未完了、#重要、#要復習&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;ページリンク([[]])の特徴&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;特定の「主題」についての詳細な記述に適している&lt;&#x2F;li&gt;
&lt;li&gt;概念間の関係性を表現しやすい&lt;&#x2F;li&gt;
&lt;li&gt;例：&lt;code&gt;[[数学]]&lt;&#x2F;code&gt;、&lt;code&gt;[[微分]]&lt;&#x2F;code&gt;、&lt;code&gt;[[Newton]]&lt;&#x2F;code&gt;&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;効果的な併用方法&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;主題と性質を組み合わせる
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;[[微分]]&lt;&#x2F;code&gt; のページに #数学 #要復習を付ける&lt;&#x2F;li&gt;
&lt;li&gt;&lt;code&gt;[[読書記録]]&lt;&#x2F;code&gt; のページに #継続中 #インプットを付ける&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;概念の関係性を示す
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;[[微分]]&lt;&#x2F;code&gt;のページで &lt;code&gt;[[極限]]&lt;&#x2F;code&gt; と &lt;code&gt;[[関数]]&lt;&#x2F;code&gt; を参照しつつ、#数学を付ける&lt;&#x2F;li&gt;
&lt;li&gt;&lt;code&gt;[[Newton]]&lt;&#x2F;code&gt;のページで &lt;code&gt;[[力学]]&lt;&#x2F;code&gt; を参照しつつ、#物理学者を付ける&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;p&gt;このように、タグとページリンクはそれぞれの特徴を活かして使うことで、より効率的な知識管理が可能になります。&lt;&#x2F;p&gt;
&lt;h2 id=&quot;知識のつながりを作る&quot;&gt;知識のつながりを作る&lt;&#x2F;h2&gt;
&lt;h3 id=&quot;ページ間のリンクの作り方&quot;&gt;ページ間のリンクの作り方&lt;&#x2F;h3&gt;
&lt;p&gt;LogSeqの強力な特徴は、ページ同士をつなげられることです。知識と知識を結びつけることで、新しい気づきが生まれやすくなります。&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;基本的なリンクの作り方&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;[[ページ名]]&lt;&#x2F;code&gt; と入力する（&lt;code&gt;[[&lt;&#x2F;code&gt;と&lt;code&gt;]]&lt;&#x2F;code&gt;で囲む）&lt;&#x2F;li&gt;
&lt;li&gt;リンク先のページがなければ、自動的に新しいページが作られる&lt;&#x2F;li&gt;
&lt;li&gt;エイリアスをつける場合：&lt;code&gt;[[ページ名]][表示したい文字]&lt;&#x2F;code&gt;
&lt;ul&gt;
&lt;li&gt;例：&lt;code&gt;[[アインシュタイン]][彼]&lt;&#x2F;code&gt;と書くと、「彼」と表示される&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;効果的なリンクの付け方&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;重要な概念や用語が出てきたらリンクにする&lt;&#x2F;li&gt;
&lt;li&gt;関連する話題が出てきたら積極的にリンクする&lt;&#x2F;li&gt;
&lt;li&gt;あとで詳しく書きたい内容があればリンクにする&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;h3 id=&quot;バックリンクの概念と確認方法&quot;&gt;バックリンクの概念と確認方法&lt;&#x2F;h3&gt;
&lt;p&gt;バックリンクとは、「どのページからリンクされているか」を示す機能です。自動的に作られる双方向のつながりにより、知識の関係性が見えてきます。&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;バックリンクの特徴&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;自動的に作られる（手動で作る必要はない）&lt;&#x2F;li&gt;
&lt;li&gt;右サイドバーに表示される&lt;&#x2F;li&gt;
&lt;li&gt;リンク元のページの該当部分が引用として表示される&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;バックリンクの活用法&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;関連する記述を後から発見できる&lt;&#x2F;li&gt;
&lt;li&gt;同じ概念が出てくる文脈を確認できる&lt;&#x2F;li&gt;
&lt;li&gt;知識のunexpectedな関連性に気づける&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;h3 id=&quot;関連する情報のつながりを見つける方法&quot;&gt;関連する情報のつながりを見つける方法&lt;&#x2F;h3&gt;
&lt;p&gt;LogSeqには、知識のつながりを見つけるための様々な機能があります。&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;グラフビュー&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;ページ間のつながりを視覚的に表示&lt;&#x2F;li&gt;
&lt;li&gt;右上のグラフアイコンをクリック&lt;&#x2F;li&gt;
&lt;li&gt;ノードをクリックすると関連するページに移動&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;検索機能の活用&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;キーワードで関連ページを検索&lt;&#x2F;li&gt;
&lt;li&gt;タグとページリンクを組み合わせて検索&lt;&#x2F;li&gt;
&lt;li&gt;日付範囲を指定して検索&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;知識のつながりを育てる方法&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;定期的にバックリンクを確認する&lt;&#x2F;li&gt;
&lt;li&gt;関連しそうなページを積極的にリンクする&lt;&#x2F;li&gt;
&lt;li&gt;グラフビューで全体の構造を確認する&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;p&gt;このように、LogSeqでは知識同士を様々な方法でつなげることができます。つながりが増えるほど、新しい発見や気づきが生まれやすくなります。&lt;&#x2F;p&gt;
&lt;h2 id=&quot;まとめ&quot;&gt;まとめ&lt;&#x2F;h2&gt;
&lt;h3 id=&quot;日常的な使い方のおすすめパターン&quot;&gt;日常的な使い方のおすすめパターン&lt;&#x2F;h3&gt;
&lt;p&gt;LogSeqを効果的に活用するために、以下のような使い方がおすすめです。&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;1日の基本的な流れ&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;朝：今日やることを箇条書きで書き出す&lt;&#x2F;li&gt;
&lt;li&gt;日中：思いついたことを &lt;code&gt;[[]]&lt;&#x2F;code&gt; でリンクしながらメモ&lt;&#x2F;li&gt;
&lt;li&gt;夜：その日の振り返りと、重要な項目に &lt;code&gt;#タグ&lt;&#x2F;code&gt; をつける&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;知識を育てる方法&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;気になる言葉は積極的に &lt;code&gt;[[]]&lt;&#x2F;code&gt; でリンク&lt;&#x2F;li&gt;
&lt;li&gt;関連する過去のメモは右サイドバーのバックリンクで確認&lt;&#x2F;li&gt;
&lt;li&gt;時々グラフビューを開いて知識の関係性を見直す&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;継続的な活用のコツ&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;完璧を目指さず、まずはメモを取ることから始める&lt;&#x2F;li&gt;
&lt;li&gt;少しずつ機能を試して、自分に合う使い方を見つける&lt;&#x2F;li&gt;
&lt;li&gt;定期的に過去のメモを見返して、知識をアップデート&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;h3 id=&quot;困ったときの対処法&quot;&gt;困ったときの対処法&lt;&#x2F;h3&gt;
&lt;p&gt;LogSeqを使っていて困ったときは、以下の方法を試してみましょう。&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;書き方を忘れたとき&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;Markdownの基本：&lt;code&gt;#&lt;&#x2F;code&gt; で見出し、&lt;code&gt;-&lt;&#x2F;code&gt; で箇条書き&lt;&#x2F;li&gt;
&lt;li&gt;リンクとタグ：&lt;code&gt;[[ページ名]]&lt;&#x2F;code&gt; と &lt;code&gt;#タグ名&lt;&#x2F;code&gt;&lt;&#x2F;li&gt;
&lt;li&gt;これらは画面下部のヘルプアイコンでいつでも確認可能&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;情報が見つからないとき&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;検索バーに関連するキーワードを入力&lt;&#x2F;li&gt;
&lt;li&gt;タグで絞り込み検索&lt;&#x2F;li&gt;
&lt;li&gt;グラフビューで関連ページを探す&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;整理が必要と感じたとき&lt;&#x2F;strong&gt;&lt;&#x2F;p&gt;
&lt;ul&gt;
&lt;li&gt;関連する情報を新しいページにまとめる&lt;&#x2F;li&gt;
&lt;li&gt;適切なタグをつけて分類する&lt;&#x2F;li&gt;
&lt;li&gt;不要になったメモは、アーカイブとしてタグ付け&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;&#x2F;li&gt;
&lt;&#x2F;ul&gt;
&lt;p&gt;LogSeqは、使い始めは普通のメモ帳として、慣れてきたら知識を育てるツールとして活用できます。一度にすべての機能を使いこなす必要はありません。自分のペースで、少しずつ使い方を広げていってください。&lt;&#x2F;p&gt;
</content>
        <summary type="html">I created this simple guide to LogSeq to help friends get started with the tool. Written in Japanese, this overview aims to help new users understand LogSeq&#x27;s key features and daily usage patterns from a bird&#x27;s-eye perspective.</summary>
        </entry>
</feed>
