Vimwiki : Vimベースの個人用Wiki環境 #3 Wikiページ記法

概要

Vimwiki : Personal Wiki for Vim
http://www.vim.org/scripts/script.php?script_id=2226

このページでは、VimwikiのWikiページの記述方法について説明します。
「 Vimwiki : Vimベースの個人用Wiki環境 #1 インストールから基本的な使い方まで 」の続きとなる記事です。

見出し・タイトル

見出しやタイトルは、行を同数の「=」で囲むことで表現します。
「=」の数が多いほどに小さな見出しになります。

= 見出し Level 1 =
== 見出し Level 2 ==
=== 見出し Level 3 ===
==== 見出し Level 4 ====
===== 見出し Level 5 =====
====== 見出し Level 6 ======

HTML化した時には、次のように表現されます。

<h1>見出し Level 1</h1>
<h2>見出し Level 2</h2>
<h3>見出し Level 3</h3>
<h4>見出し Level 4</h4>
<h5>見出し Level 5</h5>
<h6>見出し Level 6</h6>

テーブル

テーブル構造は各セルを「||」で区切って、値を並べることで表現します。

||Years||Temperature (low)||Temperature (high)||
||1900 ||-10              ||25                ||
||1910 ||-15              ||30                ||
||1920 ||-10              ||32                ||
||1930 ||-20              ||29                ||
||1940 ||-2               ||40                ||

Years
Temperature (low)
Temperature (high)


1900 
-10              
25                


1910 
-15              
30                


1920 
-10              
32                


1930 
-20              
29                


1940 
-2               
40                

テーブルのセルの中でも、リンクやボールド書体を扱えます。
左寄せ、右寄せ、センタリングは、セルの左端右端、どちらに半角スペースがあるか、両方にあるか、でコントロールします。

|| Sequence || セル内のコントロール || 文字装飾、リンク  ||
||090518001 ||左寄せ                || *ボールド*        ||
||090518002 ||                右寄せ|| _イタリック_      ||
||090518003 || センタリング         || https://nanasi.jp/ ||

リスト

* Bulleted list item 1
* Bulleted list item 2
   * Bulleted list sub item 1
   * Bulleted list sub item 2
   * more ...
     * and more ...
     * ...
   * Bulleted list sub item 3
   * etc.

<ul>
    <li>Bulleted list item 1</li>
    <li>Bulleted list item 2</li>
    <ul>
        <li>Bulleted list sub item 1</li>
        <li>Bulleted list sub item 2</li>
        <li>more ...</li>
    <ul>
        <li>and more ...</li>
        <li>...</li>
    </ul>
        <li>Bulleted list sub item 3</li>
        <li>etc.</li>
    </ul>
</ul>

# Numbered list item 1
# Numbered list item 2
    # Numbered list sub item 1
    # Numbered list sub item 2
    # more ...
        # and more ...
        # ...
    # Numbered list sub item 3
    # etc.

<ol>
    <li>Numbered list item 1</li>
    <li>Numbered list item 2</li>
    <ol>
        <li>Numbered list sub item 1</li>
        <li>Numbered list sub item 2</li>
        <li>more ...</li>
    <ol>
        <li>and more ...</li>
        <li>...</li>
    </ol>
        <li>Numbered list sub item 3</li>
        <li>etc.</li>
    </ol>
</ol>

TODOリスト

リストの先頭に「[ ]」を入れると、そのリスト項目はTODOリストとして扱われます。

* [ ] Bulleted list item 1
* [ ] Bulleted list item 2
   * [ ] Bulleted list sub item 1
   * [ ] Bulleted list sub item 2
   * [ ] more ...
     * [ ] and more ...
     * [ ] ...
   * [ ] Bulleted list sub item 3
   * [ ] etc.

TODOリストの項目の上では、Controlキーを押しながらSpaceキーを押下することで、
[ ] の中にチェックを入れたり、外したりできます。

* [x] Bulleted list item 1
* [ ] Bulleted list item 2
   * [ ] Bulleted list sub item 1

内部リンク

Wikiページ間でリンクを張るには、 英語大文字始まりのキャメルケースの綴りの語を書くか、

LinkToTopPage

角括弧２つでリンクを張りたい語を囲みます。

[[link to Top Page]]

↑↓ リンクは、リンク先のページが無いと、Wikiページ上でハイライト表示されます。

外部リンク

<!-- テキストリンク 方法1 -->
https://nanasi.jp/var/articles/vim/vimwiki/vimwiki_vim.html

<!-- テキストリンク 方法2 -->
[https://nanasi.jp/]

<!-- テキストリンク 方法3 テキストにリンクを張る -->
[https://nanasi.jp/ 名無しのvim使い]

<!-- テキストリンク 方法4 テキストにリンクを張る。相対パス。 -->
[[./index.html|名無しのvim使い]]

<!-- 画像リンク 方法1 -->
https://nanasi.jp/logo.png

<!-- 画像リンク 方法2 -->
[[https://nanasi.jp/logo.png]]

<!-- 画像リンク 方法3 相対パス -->
[[image/logo.png]]

<!-- 画像リンク 方法4 サムネイル画像 -->
[[https://nanasi.jp/logo.png|https://nanasi.jp/log_thumbnail.png]]

<!-- 画像リンク 方法5 スタイル指定 -->
[[https://nanasi.jp/logo.png||width:150px; height:120px;]]

<!-- 画像リンク 方法6 サムネイル＋スタイル指定 -->
[[https://nanasi.jp/logo.png|https://nanasi.jp/log_thumbnail.png|width:150px; height:120px;]]

書体

Vimwikiで、書体を扱うには次のように記述します。

*ボールド*

_イタリック_

~~取り消し線~~

`書体なし（コード記述用）`

本文^上付文字^

本文,,下付文字,,

HTML化した際には、それぞれ次のように表示されます。

ボールド
イタリック
取り消し線
書体なし（コード記述用）
本文上付文字
本文下付文字

パラグラフ

行頭が空白文字から始まらない場合、その行をパラグラフとして扱います。
例外は整形済みテキスト、テーブルの場合です。

整形済みテキスト

行頭を空白文字で始めるか、指定範囲を「{{{」「}}}」で囲むと、
それらテキストを整形済みテキストとして扱います。

{{{
行頭を空白文字で始めるか、指定範囲を「{{{」「}}}」で囲むと、
それらテキストは整形済みテキストとして扱います。
}}}

HTML化すると、次のようなHTMLソースが生成されます。

<code><pre>
行頭を空白文字で始めるか、指定範囲を「{{{」「}}}」で囲むと、
それらテキストは整形済みテキストとして扱います。
</pre></code>

{{{class="pre_class" id="pre_txt"
行頭を空白文字で始めるか、指定範囲を「{{{」「}}}」で囲むと、
それらテキストは整形済みテキストとして扱います。
}}}

コメント

コメントアウトの書式は、HTML、XMLのコメントアウトと同じです。
「<!--」と「-->」で囲まれたエリアは、HTML化された際に無視されます。

<!--
このエリアに書かれたテキストは
HTML化する際、出力されません。
-->

ページリンク

1. Vimwiki : Vimベースの個人用Wiki環境 #1 インストールから基本的な使い方まで
2. Vimwiki : Vimベースの個人用Wiki環境 #2 Vimwikiの操作
3. • Vimwiki : Vimベースの個人用Wiki環境 #3 Wikiページ記法
4. Vimwiki : Vimベースの個人用Wiki環境 #4 設定・カスタマイズ